Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

ArgumentOutOfRangeException — argument poza dozwolonym zakresem

System.ArgumentOutOfRangeException sygnalizuje, że wartość argumentu nie należy do zbioru dopuszczanego przez metodę. Wyjątek może wskazywać nazwę parametru oraz odrzuconą wartość.

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

Składnia

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

System.ArgumentOutOfRangeException dziedziczy po ArgumentException. Zgłaszaj go, gdy argument ma wartość poza zakresem określonym przez metodę, na przykład procent większy niż 100. Zakres wynika z kontraktu metody, a nie tylko z ograniczeń typu liczbowego.

Konstruktor ArgumentOutOfRangeException(string, object, string) przyjmuje kolejno nazwę parametru, odrzuconą wartość i komunikat. Użyj nameof(percentage), aby wskazać parametr. Właściwość ParamName udostępnia jego nazwę, a ActualValue — wartość, jeżeli została przekazana do wyjątku. Nie zakładaj, że każdy taki wyjątek zawiera ActualValue.

Zwykle należy poprawić wywołanie lub sprawdzić dane wejściowe zamiast używać wyjątków do zwykłego sterowania przepływem. W przykładzie catch służy wyłącznie demonstracji. Kod wypisuje wybrane właściwości zamiast pełnego Message, dzięki czemu oczekiwany wynik nie zależy od języka komunikatów środowiska.

Przykłady

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

Wynik

50
percentage: 101

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła