CKTIS / C#
IndexOutOfRangeException — indeks poza granicami
System.IndexOutOfRangeException sygnalizuje między innymi próbę odczytu lub zapisu elementu tablicy pod nieprawidłowym indeksem. Zwykle należy poprawić obliczanie indeksu lub granice pętli, zamiast używać wyjątku do sterowania przebiegiem programu.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }System.IndexOutOfRangeException to wyjątek zgłaszany między innymi przy odczycie lub zapisie elementu tablicy poza jej granicami. Zwykle oznacza błąd w kodzie, którego przyczynę należy znaleźć i usunąć, a nie ukrywać przez przechwytywanie wyjątku.
Dla jednowymiarowej tablicy int[] poprawny indeks spełnia warunek 0 <= index && index < values.Length. Length oznacza liczbę elementów, nie ostatni indeks. W pustej tablicy żaden indeks nie jest poprawny. W pętli używaj i < values.Length, nie i <= values.Length; jeśli potrzebujesz tylko wartości, wybierz foreach.
Nie każdy indeksator zgłasza ten sam wyjątek. List<T> dla indeksu mniejszego od 0 albo większego lub równego Count zgłasza ArgumentOutOfRangeException, a nie IndexOutOfRangeException. Typ wyjątku zależy od używanego API, mimo podobnej składni [].
Przykład celowo odczytuje values[values.Length] i przechwytuje wyjątek wyłącznie demonstracyjnie. Następnie poprawna pętla wypisuje wszystkie elementy. W rzeczywistym kodzie popraw granice lub sprawdź indeks przed dostępem; nie traktuj catch jako zwykłego warunku zakończenia pętli.
Przykłady
using System;
internal static class Program
{
private static void Main()
{
int[] values = { 10, 20, 30 };
int index = values.Length;
try
{
Console.WriteLine(values[index]);
}
catch (IndexOutOfRangeException ex)
{
Console.WriteLine(ex.GetType().Name);
}
for (int i = 0; i < values.Length; i++)
{
Console.WriteLine(values[i]);
}
}
}Wynik
IndexOutOfRangeException 10 20 30
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.