Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes