Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

ArgumentOutOfRangeException — argument mimo povolený rozsah

System.ArgumentOutOfRangeException signalizuje, že hodnota argumentu nepatrí do množiny hodnôt prijímaných metódou. Výnimka môže uviesť názov parametra a odmietnutú hodnotu.

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

Syntax

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

System.ArgumentOutOfRangeException dedí z ArgumentException. Vyvolajte ju, keď má argument hodnotu mimo rozsahu určeného metódou, napríklad percento väčšie ako 100. Rozsah vyplýva zo zmluvy metódy, nielen z hraníc číselného typu.

Konštruktor ArgumentOutOfRangeException(string, object, string) prijíma v tomto poradí názov parametra, odmietnutú hodnotu a správu. Na označenie parametra použite nameof(percentage). Vlastnosť ParamName sprístupňuje jeho názov a ActualValue sprístupňuje hodnotu, ak bola výnimke odovzdaná. Nepredpokladajte, že každá takáto výnimka obsahuje ActualValue.

Zvyčajne opravte volanie alebo overte vstup namiesto používania výnimiek na bežné riadenie toku programu. V príklade slúži catch iba na demonštráciu. Kód vypisuje vybrané vlastnosti namiesto celej hodnoty Message, takže očakávaný výstup nezávisí od jazyka správ runtime prostredia.

Prí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ýsledok

50
percentage: 101

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje