Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

ArgumentOutOfRangeException — argomento fuori dall’intervallo consentito

System.ArgumentOutOfRangeException segnala che il valore di un argomento non rientra tra quelli accettati da un metodo. L’eccezione può indicare il nome del parametro e il valore rifiutato.

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

Sintassi

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

System.ArgumentOutOfRangeException deriva da ArgumentException. Sollevala quando un argomento ha un valore fuori dall’intervallo definito dal metodo, per esempio una percentuale superiore a 100. L’intervallo è stabilito dal contratto del metodo, non soltanto dai limiti del tipo numerico.

Il costruttore ArgumentOutOfRangeException(string, object, string) accetta, nell’ordine, il nome del parametro, il valore rifiutato e il messaggio. Usa nameof(percentage) per indicare il parametro. La proprietà ParamName espone il suo nome, mentre ActualValue espone il valore, se è stato fornito all’eccezione. Non presumere che tutte queste eccezioni contengano un ActualValue.

Di solito, correggi la chiamata o convalida l’input invece di usare le eccezioni per il normale flusso di controllo. Nell’esempio, catch serve solo a scopo dimostrativo. Il codice stampa alcune proprietà invece di Message per intero, così il risultato atteso non dipende dalla lingua dei messaggi dell’ambiente di esecuzione.

Esempi

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}");
        }
    }
}

Risultato

50
percentage: 101

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti