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.