Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti