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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.