CKTIS / C#
ArgumentOutOfRangeException — argument izvan dopuštenog raspona
System.ArgumentOutOfRangeException označava da vrijednost argumenta nije među vrijednostima koje metoda prihvaća. Iznimka može navesti naziv parametra i odbijenu vrijednost.
Verzija: .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 nasljeđuje ArgumentException. Bacite tu iznimku kada argument ima vrijednost izvan raspona koji određuje metoda, primjerice postotak veći od 100. Raspon proizlazi iz ugovora metode, a ne samo iz granica brojčanog tipa.
Konstruktor ArgumentOutOfRangeException(string, object, string) prima redom naziv parametra, odbijenu vrijednost i poruku. Upotrijebite nameof(percentage) za navođenje parametra. Svojstvo ParamName otkriva njegov naziv, a ActualValue otkriva vrijednost ako je proslijeđena iznimci. Nemojte pretpostaviti da svaka takva iznimka sadrži ActualValue.
U pravilu ispravite poziv ili provjerite ulazne podatke umjesto da iznimke koristite za uobičajeni tijek izvođenja programa. U primjeru catch služi samo za demonstraciju. Kôd ispisuje odabrana svojstva umjesto cijelog Message, pa očekivani ispis ne ovisi o jeziku poruka okruženja izvođenja.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.