Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

ArgumentOutOfRangeException — argument mimo povolený rozsah

System.ArgumentOutOfRangeException signalizuje, že hodnota argumentu nepatří do množiny hodnot přijímaných metodou. Výjimka může uvést název parametru a odmítnutou hodnotu.

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

Syntaxe

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

System.ArgumentOutOfRangeException dědí z ArgumentException. Vyvolejte ji, když má argument hodnotu mimo rozsah určený metodou, například procento vyšší než 100. Rozsah vyplývá ze smlouvy metody, nikoli pouze z mezí číselného typu.

Konstruktor ArgumentOutOfRangeException(string, object, string) přijímá v tomto pořadí název parametru, odmítnutou hodnotu a zprávu. K označení parametru použijte nameof(percentage). Vlastnost ParamName zpřístupňuje jeho název a ActualValue zpřístupňuje hodnotu, pokud byla výjimce předána. Nepředpokládejte, že každá taková výjimka obsahuje ActualValue.

Obvykle opravte volání nebo ověřte vstup, místo abyste výjimky používali pro běžné řízení toku programu. V příkladu slouží catch pouze k demonstraci. Kód vypisuje vybrané vlastnosti namísto celé hodnoty Message, takže očekávaný výstup nezávisí na jazyce zpráv běhového prostředí.

Příklady

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

Výsledek

50
percentage: 101

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje