WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

ArgumentOutOfRangeException — Argument außerhalb des zulässigen Bereichs

System.ArgumentOutOfRangeException signalisiert, dass ein Argumentwert außerhalb der von einer Methode akzeptierten Menge liegt. Die Ausnahme kann den Parameternamen und den zurückgewiesenen Wert angeben.

Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

throw new ArgumentOutOfRangeException(nameof(parameter), parameter, "Allowed range description.");

System.ArgumentOutOfRangeException leitet sich von ArgumentException ab. Lösen Sie sie aus, wenn ein Argument einen Wert außerhalb des von der Methode festgelegten Bereichs hat, etwa einen Prozentsatz über 100. Der Bereich ergibt sich aus dem Vertrag der Methode und nicht nur aus den Grenzen des Zahlentyps.

Der Konstruktor ArgumentOutOfRangeException(string, object, string) erwartet der Reihe nach den Parameternamen, den zurückgewiesenen Wert und die Meldung. Verwenden Sie nameof(percentage), um den Parameter anzugeben. Die Eigenschaft ParamName stellt seinen Namen bereit, während ActualValue den Wert bereitstellt, falls er der Ausnahme übergeben wurde. Gehen Sie nicht davon aus, dass jede solche Ausnahme ein ActualValue enthält.

Üblicherweise sollten Sie den Aufruf korrigieren oder die Eingabe prüfen, statt Ausnahmen für den normalen Ablauf der Programmausführung zu verwenden. Im Beispiel dient catch nur der Demonstration. Der Code gibt ausgewählte Eigenschaften statt der vollständigen Message aus. Dadurch ist die erwartete Ausgabe unabhängig von der Sprache der Meldungen der Laufzeitumgebung.

Beispiele

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}");
        }
    }
}

Ergebnis

50
percentage: 101

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen