System.ArgumentOutOfRangeException: Index must be within the bounds of the List. (Parameter 'index')
Ai apelat `List.Insert(index, ...)` cu un index mai mare decât numărul de elemente (sau negativ). La `Insert` indexul poate fi între `0` și `Count` inclusiv (`Count` = adaugă la final). Verifică indexul, scade 1 dacă pornești numărătoarea de la 1, sau folosește `Add` pentru final.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
List<T>.Insert(index, element) mută elementele de la index încolo cu o poziție și pune noul element în locul eliberat. Indexul valid e între 0 și Count: Insert(0, x) pune la început, Insert(lista.Count, x) pune la final, ca Add. Orice valoare mai mare decât Count sau negativă aruncă System.ArgumentOutOfRangeException: Index must be within the bounds of the List. (Parameter 'index').
Mesajul e diferit de Index was out of range. Must be non-negative and less than the size of the collection., primit la citire sau la RemoveAt, unde indexul trebuie să fie strict mai mic decât Count.
Cauze frecvente:
- poziția vine de la utilizator, numerotată de la 1, și o folosești direct ca index;
- inserezi pe baza unui index calculat pe altă listă, mai lungă;
- inserezi într-o listă goală la o poziție diferită de 0.
Când citești stiva de apeluri, linia cu Insert din codul tău e cea de verificat; valoarea reală a indexului o vezi cu un Console.WriteLine sau în debugger.
De ce apare: cauzele frecvente
1Poziție numerotată de la 1 folosită ca index
var lista = new List<string> { "A", "B", "C" };
int pozitie = 4; // „a patra”
lista.Insert(pozitie, "D");var lista = new List<string> { "A", "B", "C" };
int pozitie = 4; // „a patra”
lista.Insert(pozitie - 1, "D");Pozițiile 1..n corespund indecșilor 0..n-1; a patra poziție e indexul 3, adică finalul listei.
2Inserare într-o listă goală
var coada = new List<int>();
coada.Insert(1, 42);var coada = new List<int>();
coada.Insert(0, 42);Într-o listă goală singurul index valid pentru Insert e 0.
3Indexul calculat poate depăși lista
lista.Insert(index, element);lista.Insert(Math.Clamp(index, 0, lista.Count), element);Math.Clamp limitează indexul la intervalul permis; alternativ, validează și raportează eroarea.
Repară eroarea, direct în pagină
Programul inserează o melodie într-un playlist la poziția aleasă de utilizator (numerotată de la 1), dar se oprește cu System.ArgumentOutOfRangeException: Index must be within the bounds of the List. (Parameter 'index'). Repară inserarea ca programul să afișeze 1. Intro, 2. Vara, 3. Toamna, 4. Final.
var playlist = new List<string> { "Intro", "Vara", "Toamna" };
int pozitie = 4;
playlist.Insert(pozitie, "Final");
for (int i = 0; i < playlist.Count; i++)
Console.WriteLine($"{i + 1}. {playlist[i]}");1. Intro 2. Vara 3. Toamna 4. Final
Indiciu
Pozițiile utilizatorului încep de la 1, indecșii listei de la 0.
Reparația
var playlist = new List<string> { "Intro", "Vara", "Toamna" };
int pozitie = 4;
playlist.Insert(pozitie - 1, "Final");
for (int i = 0; i < playlist.Count; i++)
Console.WriteLine($"{i + 1}. {playlist[i]}");De ce merge
Utilizatorul a ales poziția 4, adică indexul 3, care e chiar finalul listei cu trei elemente. Insert(4, ...) cerea un index mai mare decât Count, deci nu era permis. Cu pozitie - 1, melodia Final ajunge pe ultimul loc, iar bucla afișează lista numerotată de la 1.
Alte forme ale mesajului
System.ArgumentOutOfRangeException: Index must be within the bounds of the List. (Parameter 'index') Actual value was 4.
Cum o eviți pe viitor
- Ține minte intervalele: la citire,
RemoveAtși setare indexul e între0șiCount - 1; laInserte între0șiCount. - Convertește pozițiile afișate utilizatorului (de la 1) în indecși (de la 0) într-un singur loc.
- Pentru adăugare la final folosește
Add, nuInsert(lista.Count, ...).
Întrebări frecvente
De ce Insert(Count) merge, dar lista[Count] nu?
Pentru că Insert(Count, x) înseamnă „pune după ultimul element”, ceea ce e o operație validă. lista[Count] ar citi un element care nu există.
Insert e lent pe liste mari?
La început sau la mijloc, da: toate elementele de după index se mută. Dacă inserezi des la început, LinkedList<T> sau o coadă (Queue<T>, Deque propriu) pot fi mai potrivite.
Erori înrudite
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. 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.ArgumentOutOfRangeException: count ('-1') must be a non-negative value. (Parameter 'count') Ai trimis un număr negativ unei metode care cere o lungime sau un număr de elemente: `new string(' ', n)`, `PadLeft(n)`, `Substring(start, n)`, `GetRange`, `Enumerable.Range`. De obicei `n` e calculat (`latime - text.Length`) și a ieșit negativ. Limitează-l cu `Math.Max(0, n)` sau folosește o metodă care tratează singură cazul (`PadRight`). Î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.
