...
Eroare C# · Excepții cu tablouri, liste, dicționare și LINQ

System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')

Pe scurt

Ai accesat într-o listă (`List<T>`) un indice care nu există: negativ sau mai mare ori egal cu `Count`. Indicii valizi sunt de la 0 la `Count - 1`; verifică bucla (`i < lista.Count`) și dacă lista are elementele la care te aștepți.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul spune exact regula: indicele trebuie să fie „non-negative and less than the size of the collection”, adică între 0 și Count - 1. (Parameter 'index') arată că problema e la parametrul index al indexatorului listei (lista[index]). Stack trace-ul conține System.Collections.Generic.List1.get_Item(Int32 index) (la citire) sau set_Item` (la scriere), urmat de linia ta.

Cauzele sunt aceleași ca la tablouri: bucla cu <= în loc de <; accesul la lista[0] pe o listă goală; un indice calculat greșit; sau lista s-a micșorat după un Remove și indicii vechi nu mai sunt valizi.

Excepția apare și la alte metode, cu alt parametru în paranteză: RemoveAt(5), Insert(10, x) sau text.Substring(2, 50) pe un text mai scurt (acolo mesajul e despre length sau startIndex). Spre deosebire de tablouri, o listă nouă creată cu new List<int>(10) are capacitate 10, dar Count 0: nu poți scrie lista[0] = 5, trebuie Add.

De ce apare: cauzele frecvente

1Listă goală accesată la [0]

Greșit
C#
var comenzi = new List<string>();
Console.WriteLine(comenzi[0]);
Corect
C#
var comenzi = new List<string>();
Console.WriteLine(comenzi.Count > 0 ? comenzi[0] : "nicio comanda");

O listă goală nu are niciun indice valid. Verifică Count înainte.

2Capacitate confundată cu dimensiunea

Greșit
C#
var note = new List<int>(3);
note[0] = 9;
Corect
C#
var note = new List<int>(3);
note.Add(9);

Argumentul din constructor e doar capacitatea rezervată; lista are 0 elemente până la primul Add.

3Substring mai lung decât textul

Greșit
C#
string cod = "AB12";
Console.WriteLine(cod.Substring(2, 5));
Corect
C#
string cod = "AB12";
Console.WriteLine(cod.Substring(2, Math.Min(5, cod.Length - 2)));

Substring(start, lungime) cere ca start + lungime să nu depășească lungimea textului (aici (Parameter 'length')).

Repară tu

Repară eroarea, direct în pagină

Programul afișează lista de așteptare de la un ghișeu, cu numărul de ordine, dar la rulare primești System.ArgumentOutOfRangeException: Index was out of range. Repară bucla, astfel încât să afișeze toți clienții din listă, apoi numărul lor.

Codul care dă eroarea
C#
var clienti = new List<string> { "Ana", "Mihai", "Elena" };

for (int i = 0; i <= clienti.Count; i++)
    Console.WriteLine($"{i + 1}. {clienti[i]}");

Console.WriteLine($"In asteptare: {clienti.Count}");
După reparație, programul afișează
1. Ana
2. Mihai
3. Elena
In asteptare: 3
Indiciu

Condiția buclei trebuie să fie i < clienti.Count.

Alte forme ale mesajului

  • System.ArgumentOutOfRangeException: Index and length must refer to a location within the string. (Parameter 'length')
  • System.ArgumentOutOfRangeException: startIndex cannot be larger than length of string. (Parameter 'startIndex')

Cum o eviți pe viitor

  • Parcurge listele cu foreach sau cu for (int i = 0; i < lista.Count; i++).
  • Verifică Count (sau Any()) înainte de a accesa poziții fixe.
  • Folosește metodele sigure LINQ: FirstOrDefault(), LastOrDefault(), ElementAtOrDefault(i).
  • Adaugă elemente cu Add, nu prin atribuire la un indice nou.
  • Când ștergi elemente într-o buclă for, parcurge lista de la final spre început.

Întrebări frecvente

De ce la listă primesc ArgumentOutOfRangeException, iar la tablou IndexOutOfRangeException?

Accesul la tablou este o operație a runtime-ului, care aruncă IndexOutOfRangeException. Accesul la listă trece prin metoda indexatorului, care validează argumentul index și aruncă ArgumentOutOfRangeException. Cauza e aceeași.

Cum iau ultimul element dintr-o listă?

Cu lista[^1] sau lista[lista.Count - 1], după ce verifici că lista nu e goală. Varianta sigură: lista.LastOrDefault().

Erori înrudite

← Toate erorile C#

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață C# de la zero, cu exerciții la fiecare lecție

Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.