CKTIS / C#
ArgumentOutOfRangeException — argument buiten het toegestane bereik
System.ArgumentOutOfRangeException geeft aan dat een argumentwaarde buiten de verzameling waarden valt die een methode accepteert. De uitzondering kan de parameternaam en de afgewezen waarde vermelden.
Versie: .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 is afgeleid van ArgumentException. Werp deze uitzondering wanneer een argument een waarde heeft buiten het bereik dat de methode definieert, bijvoorbeeld een percentage hoger dan 100. Het bereik volgt uit het contract van de methode, niet alleen uit de grenzen van het numerieke type.
De constructor ArgumentOutOfRangeException(string, object, string) verwacht achtereenvolgens de parameternaam, de afgewezen waarde en het bericht. Gebruik nameof(percentage) om de parameter aan te duiden. De eigenschap ParamName geeft de naam weer, terwijl ActualValue de waarde weergeeft als die aan de uitzondering is doorgegeven. Ga er niet van uit dat elke dergelijke uitzondering een ActualValue bevat.
Corrigeer doorgaans de aanroep of controleer de invoer, in plaats van uitzonderingen te gebruiken voor de gewone programmastroom. In het voorbeeld dient catch alleen ter demonstratie. De code geeft geselecteerde eigenschappen weer in plaats van de volledige Message, zodat de verwachte uitvoer niet afhankelijk is van de taal van de berichten van de runtime.
Voorbeelden
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}");
}
}
}Resultaat
50 percentage: 101
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.