Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri