CKTIS / C#
IndexOutOfRangeException — index mimo rozsah
System.IndexOutOfRangeException mimo jiné signalizuje pokus o čtení nebo zápis prvku pole pomocí neplatného indexu. Obvykle opravte výpočet indexu nebo meze cyklu, místo abyste výjimku používali pro běžný tok programu.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }System.IndexOutOfRangeException je výjimka, která se mimo jiné vyvolá při čtení nebo zápisu prvku pole mimo jeho rozsah. Obvykle signalizuje chybu v kódu, jejíž příčinu je třeba zjistit a opravit, nikoli ji skrývat zachycením výjimky.
Pro jednorozměrné pole int[] platí, že index je platný, pokud splňuje 0 <= index && index < values.Length. Length označuje počet prvků, nikoli poslední index. Prázdné pole nemá žádný platný index. V cyklu použijte i < values.Length, nikoli i <= values.Length; pokud potřebujete pouze hodnoty, zvolte foreach.
Ne každý indexer vyvolává stejnou výjimku. Pro index menší než 0 nebo větší či rovný Count vyvolá List<T> výjimku ArgumentOutOfRangeException, nikoli IndexOutOfRangeException. Typ výjimky závisí na použitém API, přestože syntaxe [] je podobná.
Příklad záměrně čte values[values.Length] a výjimku zachytává pouze pro demonstrační účely. Poté správný cyklus vypíše všechny prvky. Ve skutečném kódu opravte meze nebo před přístupem ověřte index; nepovažujte catch za běžnou podmínku ukončení cyklu.
Příklady
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]);
}
}
}Výsledek
IndexOutOfRangeException 10 20 30
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.