Cette documentation est archivée et n’est pas conservée.

ArgumentOutOfRangeException, constructeur (String, Object, String)

Initialise une nouvelle instance de la classe ArgumentOutOfRangeException avec un message d'erreur spécifié, le nom du paramètre et la valeur de l'argument.

Espace de noms: System
Assembly : mscorlib (dans mscorlib.dll)

public ArgumentOutOfRangeException (
	string paramName,
	Object actualValue,
	string message
)
public ArgumentOutOfRangeException (
	String paramName, 
	Object actualValue, 
	String message
)
public function ArgumentOutOfRangeException (
	paramName : String, 
	actualValue : Object, 
	message : String
)
Non applicable.

Paramètres

paramName

Nom du paramètre ayant provoqué l'exception.

actualValue

Valeur de l'argument qui provoque cette exception.

message

Message décrivant l'erreur.

Ce constructeur initialise la propriété ParamName de la nouvelle instance à l'aide du paramètre paramName, la propriété ActualValue à l'aide du paramètre actualValue et la propriété Message à l'aide du paramètre message. Le contenu des paramètres paramName et message doit être compréhensible par les utilisateurs. L'appelant de ce constructeur doit vérifier que ces chaînes ont été localisées pour la culture système en cours.

Le paramètre actualValue n'est pas utilisé dans la bibliothèque de classes du .NET Framework. Toutefois, la propriété ActualValue est fournie pour permettre aux applications d'utiliser la valeur de l'argument disponible.

Le paramètre actualValue comporte une valeur non valide qui est passée à la méthode, provoquant la levée de cette exception. Cette valeur est stockée dans la propriété ActualValue et la chaîne la représentant est ajoutée à la chaîne de message contenue dans la propriété Message.

Le tableau suivant montre les valeurs initiales des propriétés d'une instance de ArgumentOutOfRangeException.

Propriété

Valeur

ActualValue

Valeur de l'argument.

InnerException

Référence null (Nothing en Visual Basic).

Message

Chaîne du message d'erreur.

ParamName

Chaîne du nom du paramètre.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0, 1.1, 1.0
Afficher: