System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')
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]
var comenzi = new List<string>();
Console.WriteLine(comenzi[0]);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
var note = new List<int>(3);
note[0] = 9;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
string cod = "AB12";
Console.WriteLine(cod.Substring(2, 5));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ă 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.
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}");1. Ana 2. Mihai 3. Elena In asteptare: 3
Indiciu
Condiția buclei trebuie să fie i < clienti.Count.
Reparația
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}");De ce merge
Lista are 3 elemente, cu indicii 0, 1 și 2. Condiția i <= clienti.Count permitea și i = 3, iar clienti[3] nu există, deci indexatorul listei arunca ArgumentOutOfRangeException. Cu i < clienti.Count, bucla se oprește după ultimul element valid. Numărul de ordine afișat este i + 1, ca să înceapă de la 1 pentru oameni.
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
foreachsau cufor (int i = 0; i < lista.Count; i++). - Verifică
Count(sauAny()) î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
System.IndexOutOfRangeException: Index was outside the bounds of the array. Ai accesat o poziție care nu există într-un tablou (sau într-un string): de exemplu `note[3]` într-un tablou cu 3 elemente, unde indicii valizi sunt 0, 1 și 2. Folosește indici de la 0 la `Length - 1` (în bucle: `i < note.Length`, nu `<=`). System.InvalidOperationException: Sequence contains no elements Ai apelat o metodă LINQ care are nevoie de cel puțin un element (`Max`, `Min`, `Average`, `First`, `Last`, `Single`) pe o colecție goală. Verifică înainte cu `Any()` sau folosește variantele sigure: `FirstOrDefault`, `DefaultIfEmpty(0).Max()`, `MaxBy` cu verificare. System.InvalidOperationException: Collection was modified; enumeration operation may not execute. Ai adăugat sau ai șters elemente dintr-o listă (sau dicționar) în timp ce o parcurgeai cu `foreach`. Folosește `RemoveAll(conditie)`, parcurge o copie (`lista.ToList()`) sau o buclă `for` de la final spre început. Î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.
