CKTIS / C#
ArgumentOutOfRangeException — argument zunaj dovoljenega obsega
System.ArgumentOutOfRangeException sporoča, da vrednost argumenta ni med vrednostmi, ki jih metoda sprejema. Izjema lahko navede ime parametra in zavrnjeno vrednost.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
throw new ArgumentOutOfRangeException(nameof(parameter), parameter, "Allowed range description.");System.ArgumentOutOfRangeException izhaja iz ArgumentException. Sprožite jo, kadar ima argument vrednost zunaj obsega, ki ga določa metoda, na primer odstotek, večji od 100. Obseg določa pogodba metode, ne le meje številskega tipa.
Konstruktor ArgumentOutOfRangeException(string, object, string) po vrsti sprejme ime parametra, zavrnjeno vrednost in sporočilo. Za določitev parametra uporabite nameof(percentage). Lastnost ParamName razkrije njegovo ime, ActualValue pa razkrije vrednost, če je bila predana izjemi. Ne predpostavljajte, da vsaka taka izjema vsebuje ActualValue.
Običajno popravite klic ali preverite vhodne podatke, namesto da bi izjeme uporabljali za običajen potek izvajanja programa. V primeru je catch namenjen samo prikazu. Koda izpiše izbrane lastnosti namesto celotnega Message, zato pričakovani izpis ni odvisen od jezika sporočil izvajalnega okolja.
Primeri
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}");
}
}
}Rezultat
50 percentage: 101
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.