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

System.IndexOutOfRangeException: Index was outside the bounds of the array.

Pe scurt

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 `<=`).

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

Ce înseamnă

În C#, tablourile sunt indexate de la 0: un tablou cu Length elemente are indicii 0 ... Length - 1. Orice acces în afara acestui interval (un indice negativ, egal cu Length sau mai mare) aruncă la rulare IndexOutOfRangeException cu mesajul „Index was outside the bounds of the array” („indicele a fost în afara limitelor tabloului”). Aceeași excepție o primești și la text[i] pe un string în afara lungimii lui.

Stack trace-ul indică linia accesului. Uită-te la expresia din [ ] și la lungimea tabloului în acel moment.

Cea mai frecventă cauză este bucla cu <=: for (int i = 0; i <= note.Length; i++) face un pas în plus. Altele: indexare de la 1 ca în viața de zi cu zi (luni[12] pentru decembrie); accesul la v[i + 1] în ultima iterație; un tablou gol accesat la [0]; sau rezultatul unui Split cu mai puține bucăți decât te aștepți. La List<T>, aceeași greșeală dă ArgumentOutOfRangeException.

De ce apare: cauzele frecvente

1Bucla merge până la Length inclusiv

Greșit
C#
int[] note = { 7, 8, 9 };
for (int i = 0; i <= note.Length; i++)
    Console.WriteLine(note[i]);
Corect
C#
int[] note = { 7, 8, 9 };
for (int i = 0; i < note.Length; i++)
    Console.WriteLine(note[i]);

Ultimul indice valid este Length - 1. Cu <, bucla se oprește la timp.

2Accesul la elementul următor

Greșit
C#
int[] t = { 3, 5, 9 };
for (int i = 0; i < t.Length; i++)
    Console.WriteLine(t[i + 1] - t[i]);
Corect
C#
int[] t = { 3, 5, 9 };
for (int i = 0; i < t.Length - 1; i++)
    Console.WriteLine(t[i + 1] - t[i]);

Când folosești i + 1, bucla trebuie să se oprească cu un pas mai devreme.

3Rezultatul unui Split cu mai puține părți

Greșit
C#
string linie = "Ana;9";
string[] p = linie.Split(';');
Console.WriteLine(p[2]);
Corect
C#
string linie = "Ana;9";
string[] p = linie.Split(';');
Console.WriteLine(p.Length > 2 ? p[2] : "lipsa");

Linia are doar două câmpuri (indicii 0 și 1). Verifică Length înainte de acces.

Repară tu

Repară eroarea, direct în pagină

Programul calculează diferențele de temperatură de la o zi la alta, dar la rulare primești System.IndexOutOfRangeException: Index was outside the bounds of the array. Repară bucla, astfel încât să afișeze cele trei diferențe dintre cele patru zile.

Codul care dă eroarea
C#
int[] temp = { 12, 15, 11, 18 };

for (int i = 0; i < temp.Length; i++)
{
    int dif = temp[i + 1] - temp[i];
    Console.WriteLine($"Ziua {i + 1} -> {i + 2}: {dif:+0;-0;0}");
}
După reparație, programul afișează
Ziua 1 -> 2: +3
Ziua 2 -> 3: -4
Ziua 3 -> 4: +7
Indiciu

Bucla folosește temp[i + 1], deci trebuie să se oprească la i < temp.Length - 1.

Alte forme ale mesajului

  • Unhandled exception. System.IndexOutOfRangeException: Index was outside the bounds of the array.

Cum o eviți pe viitor

  • Folosește foreach când nu ai nevoie de indice: nu poate depăși limitele.
  • În for, scrie mereu i < tablou.Length.
  • Pentru ultimul element folosește tablou[^1] (C# 8+) sau tablou[tablou.Length - 1], după ce verifici că nu e gol.
  • Verifică Length înainte să accesezi poziții fixe din rezultate ca Split.
  • Când mapezi numere „umane” (luna 1–12) pe indici, scade 1.

Întrebări frecvente

De ce indicii încep de la 0?

Indicele reprezintă distanța față de începutul tabloului: primul element e la distanța 0. Toate limbajele din familia C (C, C++, Java, C#, JavaScript) folosesc această convenție.

Ce diferență e între asta și ArgumentOutOfRangeException?

Tablourile (int[]) și string-urile aruncă IndexOutOfRangeException. List<T> și alte colecții aruncă ArgumentOutOfRangeException pentru aceeași greșeală, pentru că indicele e transmis ca argument al indexatorului.

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.