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

CKTIS / C#

ArgumentOutOfRangeException — argumento fuera del intervalo permitido

System.ArgumentOutOfRangeException indica que el valor de un argumento está fuera del conjunto que acepta un método. La excepción puede identificar el nombre del parámetro y el valor rechazado.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

throw new ArgumentOutOfRangeException(nameof(parameter), parameter, "Allowed range description.");

System.ArgumentOutOfRangeException deriva de ArgumentException. Lánzala cuando un argumento tenga un valor fuera del intervalo definido por el método, como un porcentaje superior a 100. El intervalo se determina por el contrato del método, no solo por los límites del tipo numérico.

El constructor ArgumentOutOfRangeException(string, object, string) recibe, en este orden, el nombre del parámetro, el valor rechazado y el mensaje. Usa nameof(percentage) para identificar el parámetro. La propiedad ParamName proporciona su nombre, mientras que ActualValue proporciona el valor si se pasó a la excepción. No des por hecho que todas estas excepciones contienen un ActualValue.

Por lo general, corrige la llamada o valida la entrada en lugar de usar excepciones para el flujo de control habitual. En el ejemplo, catch se usa solo a modo de demostración. El código imprime propiedades concretas en vez del Message completo, por lo que el resultado esperado no depende del idioma de los mensajes del entorno de ejecución.

Ejemplos

using System;

internal static class Program
{
    private static int ValidatePercentage(int percentage)
    {
        if (percentage < 0 || percentage > 100)
        {
            throw new ArgumentOutOfRangeException(
                nameof(percentage), percentage, "Expected 0 through 100.");
        }

        return percentage;
    }

    private static void Main()
    {
        Console.WriteLine(ValidatePercentage(50));

        try
        {
            ValidatePercentage(101);
        }
        catch (ArgumentOutOfRangeException ex)
        {
            Console.WriteLine($"{ex.ParamName}: {ex.ActualValue}");
        }
    }
}

Resultado

50
percentage: 101

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