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.