База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

ArgumentOutOfRangeException — аргумент извън допустимия диапазон

System.ArgumentOutOfRangeException сигнализира, че стойността на аргумент е извън множеството, което даден метод приема. Изключението може да посочи името на параметъра и отхвърлената стойност.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

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

System.ArgumentOutOfRangeException наследява ArgumentException. Хвърлете го, когато аргумент има стойност извън диапазона, определен от метода, например процент над 100. Диапазонът произтича от договора на метода, а не само от ограниченията на числовия тип.

Конструкторът ArgumentOutOfRangeException(string, object, string) приема последователно името на параметъра, отхвърлената стойност и съобщението. Използвайте nameof(percentage), за да посочите параметъра. Свойството ParamName предоставя името му, а ActualValue предоставя стойността, ако тя е подадена на изключението. Не приемайте, че всяко такова изключение съдържа ActualValue.

Обикновено коригирайте извикването или проверявайте входните данни, вместо да използвате изключения за обичайния ход на програмата. В примера catch служи само за демонстрация. Кодът извежда избрани свойства, а не цялото Message, така че очакваният изход не зависи от езика на съобщенията на средата за изпълнение.

Примери

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

Резултат

50
percentage: 101

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници