CKTIS / C#
IndexOutOfRangeException — index mimo rozsah
System.IndexOutOfRangeException okrem iného signalizuje pokus o čítanie alebo zápis prvku poľa pomocou neplatného indexu. Zvyčajne opravte výpočet indexu alebo hranice cyklu, namiesto toho, aby ste výnimku používali na bežný tok programu.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }System.IndexOutOfRangeException je výnimka, ktorá sa okrem iného vyvolá pri čítaní alebo zápise prvku poľa mimo jeho hraníc. Zvyčajne signalizuje chybu v kóde, ktorej príčinu treba zistiť a opraviť, nie ju skrývať zachytením výnimky.
Pre jednorozmerné pole int[] platí, že index je platný, ak spĺňa 0 <= index && index < values.Length. Length označuje počet prvkov, nie posledný index. Prázdne pole nemá žiadny platný index. V cykle použite i < values.Length, nie i <= values.Length; ak potrebujete iba hodnoty, vyberte foreach.
Nie každý indexer vyvoláva rovnakú výnimku. Pri indexe menšom ako 0 alebo väčšom či rovnom Count vyvolá List<T> výnimku ArgumentOutOfRangeException, nie IndexOutOfRangeException. Typ výnimky závisí od použitého API, hoci syntax [] je podobná.
Príklad zámerne číta values[values.Length] a výnimku zachytáva iba na ukážku. Potom správny cyklus vypíše všetky prvky. V skutočnom kóde opravte hranice alebo pred prístupom overte index; nepovažujte catch za bežnú podmienku ukončenia cyklu.
Prí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ýsledok
IndexOutOfRangeException 10 20 30
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.