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.