CKTIS / C#
IndexOutOfRangeException — índice fuera de límites
System.IndexOutOfRangeException indica, entre otros casos, un intento de leer o escribir un elemento de una matriz con un índice no válido. Normalmente, corrige el cálculo del índice o los límites del bucle en lugar de usar la excepción para el flujo normal del programa.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }System.IndexOutOfRangeException es una excepción que se produce, entre otros casos, al leer o escribir un elemento de una matriz fuera de sus límites. Normalmente indica un error de programación cuya causa se debe diagnosticar y corregir, en vez de ocultarla capturando la excepción.
Para una matriz unidimensional int[], un índice válido cumple 0 <= index && index < values.Length. Length indica el número de elementos, no el último índice. Una matriz vacía no tiene ningún índice válido. En un bucle, usa i < values.Length, no i <= values.Length; si solo necesitas los valores, elige foreach.
No todos los indizadores producen la misma excepción. Para un índice menor que 0 o mayor o igual que Count, List<T> produce ArgumentOutOfRangeException, no IndexOutOfRangeException. El tipo de excepción depende de la API utilizada, aunque la sintaxis [] sea similar.
El ejemplo lee deliberadamente values[values.Length] y captura la excepción únicamente con fines demostrativos. Después, un bucle correcto muestra todos los elementos. En código real, corrige los límites o valida el índice antes de acceder; no trates catch como la condición normal para terminar un bucle.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.