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

System.ArgumentOutOfRangeException: Index must be within the bounds of the List. (Parameter 'index')

Pe scurt

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

Greșit
C#
var lista = new List<string> { "A", "B", "C" };
int pozitie = 4; // „a patra”
lista.Insert(pozitie, "D");
Corect
C#
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ă

Greșit
C#
var coada = new List<int>();
coada.Insert(1, 42);
Corect
C#
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

Greșit
C#
lista.Insert(index, element);
Corect
C#
lista.Insert(Math.Clamp(index, 0, lista.Count), element);

Math.Clamp limitează indexul la intervalul permis; alternativ, validează și raportează eroarea.

Repară tu

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.

Codul care dă eroarea
C#
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]}");
După reparație, programul afișează
1. Intro
2. Vara
3. Toamna
4. Final
Indiciu

Pozițiile utilizatorului încep de la 1, indecșii listei de la 0.

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 între 0 și Count - 1; la Insert e între 0 și Count.
  • 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, nu Insert(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

← 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.