CKTIS / C#
ArgumentOutOfRangeException — argumento fora do intervalo permitido
System.ArgumentOutOfRangeException indica que o valor de um argumento está fora do conjunto aceite por um método. A exceção pode identificar o nome do parâmetro e o valor rejeitado.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
throw new ArgumentOutOfRangeException(nameof(parameter), parameter, "Allowed range description.");System.ArgumentOutOfRangeException deriva de ArgumentException. Lance-a quando um argumento tiver um valor fora do intervalo definido pelo método, como uma percentagem superior a 100. O intervalo decorre do contrato do método, e não apenas dos limites do tipo numérico.
O construtor ArgumentOutOfRangeException(string, object, string) recebe, por esta ordem, o nome do parâmetro, o valor rejeitado e a mensagem. Utilize nameof(percentage) para identificar o parâmetro. A propriedade ParamName disponibiliza o respetivo nome, enquanto ActualValue disponibiliza o valor, caso este tenha sido fornecido à exceção. Não presuma que todas estas exceções contêm um ActualValue.
Normalmente, corrija a chamada ou valide os dados de entrada em vez de utilizar exceções para o fluxo de controlo habitual. No exemplo, catch serve apenas para demonstração. O código apresenta propriedades selecionadas em vez de toda a Message, pelo que o resultado esperado não depende do idioma das mensagens do ambiente de execução.
Exemplos
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
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.