Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

IndexOutOfRangeException — índice fora dos limites

System.IndexOutOfRangeException assinala, entre outros casos, uma tentativa de ler ou escrever um elemento de um array com um índice inválido. Normalmente, corrija o cálculo do índice ou os limites do ciclo, em vez de usar a exceção para o fluxo normal do programa.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }

System.IndexOutOfRangeException é uma exceção lançada, entre outros casos, ao ler ou escrever um elemento de um array fora dos seus limites. Normalmente, indica um erro no código cuja causa deve ser diagnosticada e corrigida, em vez de ser ocultada através da captura da exceção.

Para um array unidimensional int[], um índice válido satisfaz 0 <= index && index < values.Length. Length representa o número de elementos, não o último índice. Um array vazio não tem índices válidos. Num ciclo, use i < values.Length, não i <= values.Length; se precisar apenas dos valores, escolha foreach.

Nem todos os indexadores lançam a mesma exceção. Para um índice inferior a 0 ou superior ou igual a Count, List<T> lança ArgumentOutOfRangeException, não IndexOutOfRangeException. O tipo de exceção depende da API utilizada, apesar de a sintaxe [] ser semelhante.

O exemplo lê deliberadamente values[values.Length] e captura a exceção apenas para fins de demonstração. Em seguida, um ciclo correto apresenta todos os elementos. Em código real, corrija os limites ou valide o índice antes do acesso; não trate catch como a condição normal para terminar um ciclo.

Exemplos

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]);
        }
    }
}

Resultado

IndexOutOfRangeException
10
20
30

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes