Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori