CKTIS / C#
IndexOutOfRangeException — indice fuori dai limiti
System.IndexOutOfRangeException segnala, tra gli altri casi, un tentativo di leggere o scrivere un elemento di un array usando un indice non valido. Di solito, correggi il calcolo dell’indice o i limiti del ciclo invece di usare l’eccezione per il normale flusso del programma.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }System.IndexOutOfRangeException è un’eccezione generata, tra gli altri casi, quando si legge o scrive un elemento di un array al di fuori dei suoi limiti. Di solito indica un errore nel codice, la cui causa va individuata e corretta invece di nasconderla intercettando l’eccezione.
Per un array monodimensionale int[], un indice è valido se soddisfa 0 <= index && index < values.Length. Length indica il numero di elementi, non l’ultimo indice. Un array vuoto non ha indici validi. In un ciclo, usa i < values.Length, non i <= values.Length; se ti servono solo i valori, scegli foreach.
Non tutti gli indicizzatori generano la stessa eccezione. Per un indice minore di 0 o maggiore o uguale a Count, List<T> genera ArgumentOutOfRangeException, non IndexOutOfRangeException. Il tipo di eccezione dipende dall’API utilizzata, anche se la sintassi [] è simile.
L’esempio legge deliberatamente values[values.Length] e intercetta l’eccezione solo a scopo dimostrativo. In seguito, un ciclo corretto stampa tutti gli elementi. Nel codice reale, correggi i limiti o convalida l’indice prima dell’accesso; non considerare catch la condizione normale per terminare un ciclo.
Esempi
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]);
}
}
}Risultato
IndexOutOfRangeException 10 20 30
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.