CKTIS / C#
ArgumentOutOfRangeException — argument en dehors de la plage autorisée
System.ArgumentOutOfRangeException signale qu’une valeur d’argument ne fait pas partie de celles qu’une méthode accepte. L’exception peut indiquer le nom du paramètre et la valeur rejetée.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
throw new ArgumentOutOfRangeException(nameof(parameter), parameter, "Allowed range description.");System.ArgumentOutOfRangeException dérive de ArgumentException. Déclenchez-la lorsqu’un argument a une valeur en dehors de la plage définie par la méthode, par exemple un pourcentage supérieur à 100. Cette plage découle du contrat de la méthode, et pas seulement des limites du type numérique.
Le constructeur ArgumentOutOfRangeException(string, object, string) prend, dans l’ordre, le nom du paramètre, la valeur rejetée et le message. Utilisez nameof(percentage) pour désigner le paramètre. La propriété ParamName expose son nom, tandis que ActualValue expose la valeur si celle-ci a été fournie à l’exception. Ne partez pas du principe que toutes ces exceptions contiennent une valeur ActualValue.
En général, corrigez l’appel ou validez les données d’entrée plutôt que d’utiliser des exceptions pour le déroulement normal du programme. Dans l’exemple, catch sert uniquement à la démonstration. Le code affiche certaines propriétés plutôt que le Message complet, afin que le résultat attendu ne dépende pas de la langue des messages de l’environnement d’exécution.
Exemples
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}");
}
}
}Résultat
50 percentage: 101
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.