Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje