CKTIS / C#
IndexOutOfRangeException — indeks zunaj meja
System.IndexOutOfRangeException med drugim označuje poskus branja ali zapisovanja elementa polja z neveljavnim indeksom. Običajno popravite izračun indeksa ali meje zanke, namesto da bi izjemo uporabljali za običajen potek programa.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }System.IndexOutOfRangeException je izjema, ki se med drugim sproži pri branju ali zapisovanju elementa polja zunaj njegovih meja. Običajno kaže na napako v kodi, katere vzrok je treba ugotoviti in odpraviti, ne pa ga prikriti z ujetjem izjeme.
Za enodimenzionalno polje int[] je indeks veljaven, če izpolnjuje pogoj 0 <= index && index < values.Length. Length pomeni število elementov, ne zadnjega indeksa. Prazno polje nima veljavnega indeksa. V zanki uporabite i < values.Length, ne i <= values.Length; če potrebujete samo vrednosti, izberite foreach.
Vsi indeksatorji ne sprožijo iste izjeme. Za indeks, manjši od 0 ali večji ali enak Count, List<T> sproži ArgumentOutOfRangeException, ne IndexOutOfRangeException. Vrsta izjeme je odvisna od uporabljenega API-ja, čeprav je sintaksa [] podobna.
Primer namenoma prebere values[values.Length] in ujame izjemo samo za prikaz. Nato pravilna zanka izpiše vse elemente. V dejanski kodi popravite meje ali pred dostopom preverite indeks; catch ne uporabljajte kot običajnega pogoja za zaključek zanke.
Primeri
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]);
}
}
}Rezultat
IndexOutOfRangeException 10 20 30
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.