Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes