ArgumentException Constructeurs

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Initialise une nouvelle instance de la classe ArgumentException.

Surcharges

ArgumentException()	Initialise une nouvelle instance de la classe ArgumentException.
ArgumentException(String)	Initialise une nouvelle instance de la classe ArgumentException avec un message d'erreur spécifié.
ArgumentException(SerializationInfo, StreamingContext)	Obsolète. Initialise une nouvelle instance de la classe ArgumentException avec des données sérialisées.
ArgumentException(String, Exception)	Initialise une nouvelle instance de la classe ArgumentException avec un message d'erreur spécifié et une référence à l'exception interne ayant provoqué cette exception.
ArgumentException(String, String)	Initialise une nouvelle instance de la classe ArgumentException avec un message d’erreur spécifié et le nom du paramètre ayant provoqué cette exception.
ArgumentException(String, String, Exception)	Initialise une nouvelle instance de la classe ArgumentException avec un message d’erreur spécifié, le nom du paramètre et une référence à l’exception interne ayant provoqué cette exception.

ArgumentException()

Source:

ArgumentException.cs

Initialise une nouvelle instance de la classe ArgumentException.

public:
 ArgumentException();

public ArgumentException ();

Public Sub New ()

Remarques

Ce constructeur initialise la Message propriété du nouveau instance à un message fourni par le système qui décrit l’erreur, par exemple « Un argument non valide a été spécifié ». Ce message prend en compte la culture système actuelle.

Le tableau suivant affiche les valeurs de propriété initiales pour une instance de ArgumentException.

Propriété	Valeur
InnerException	Référence Null (Nothing en Visual Basic).
Message	Chaîne du message d'erreur localisé.

ArgumentException(String)

Source:

ArgumentException.cs

Initialise une nouvelle instance de la classe ArgumentException avec un message d'erreur spécifié.

public:
 ArgumentException(System::String ^ message);

public ArgumentException (string? message);

new ArgumentException : string -> ArgumentException

Public Sub New (message As String)

Paramètres

message

String

Message d'erreur qui explique la raison de l'exception.

Remarques

Ce constructeur initialise la Message propriété du nouveau instance à un message fourni par le système qui décrit l’erreur, par exemple « Un argument non valide a été spécifié ». Ce message prend en compte la culture système actuelle.

Le tableau suivant affiche les valeurs de propriété initiales pour une instance de ArgumentException.

Propriété	Valeur
InnerException	Référence Null (Nothing en Visual Basic).
Message	Chaîne du message d'erreur.

ArgumentException(SerializationInfo, StreamingContext)

Source:

ArgumentException.cs

Attention

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Initialise une nouvelle instance de la classe ArgumentException avec des données sérialisées.

protected:
 ArgumentException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected ArgumentException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Paramètres

info

SerializationInfo

Objet qui contient les données sérialisées de l'objet.

context

StreamingContext

Informations contextuelles sur la source ou la destination.

Attributs

ObsoleteAttribute

Remarques

Ce constructeur est appelé lors de la désérialisation afin de reconstituer l'objet exception transmis sur un flux. Pour plus d’informations, consultez Sérialisation XML et SOAP.

Voir aussi

• Sérialisation XML et SOAP

ArgumentException(String, Exception)

Source:

ArgumentException.cs

Initialise une nouvelle instance de la classe ArgumentException avec un message d'erreur spécifié et une référence à l'exception interne ayant provoqué cette exception.

public:
 ArgumentException(System::String ^ message, Exception ^ innerException);

public ArgumentException (string? message, Exception? innerException);

new ArgumentException : string * Exception -> ArgumentException

Public Sub New (message As String, innerException As Exception)

Paramètres

message

String

Message d'erreur qui explique la raison de l'exception.

innerException

Exception

Exception ayant provoqué l'exception actuelle. Si le paramètre innerException n'est pas une référence null, l'exception actuelle est levée dans un bloc catch qui gère l'exception interne.

Remarques

Ce constructeur initialise la Message propriété du nouveau instance à l’aide de la valeur du message paramètre . Le contenu du paramètre message doit être compréhensible par les utilisateurs. L'appelant de ce constructeur est requis pour vérifier que cette chaîne a été localisée pour la culture système actuelle.

Une exception levée en conséquence directe d'une exception précédente doit contenir une référence à celle-ci dans la propriété InnerException. La propriété InnerException retourne la valeur passée au constructeur ou la valeur null si la propriété InnerException ne fournit pas la valeur d'exception interne au constructeur.

Le tableau suivant affiche les valeurs de propriété initiales pour une instance de ArgumentException.

Propriété	Value
InnerException	La référence à l'exception interne.
Message	Chaîne du message d'erreur localisé.

Voir aussi

• Exception
• Gestion et levée des exceptions

ArgumentException(String, String)

Source:

ArgumentException.cs

Initialise une nouvelle instance de la classe ArgumentException avec un message d’erreur spécifié et le nom du paramètre ayant provoqué cette exception.

public:
 ArgumentException(System::String ^ message, System::String ^ paramName);

public ArgumentException (string? message, string? paramName);

new ArgumentException : string * string -> ArgumentException

Public Sub New (message As String, paramName As String)

Paramètres

message

String

Message d'erreur qui explique la raison de l'exception.

paramName

String

Nom du paramètre ayant provoqué l’exception actuelle.

Exemples

L’exemple de code suivant montre comment appeler le ArgumentException constructeur. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ArgumentException classe .

int DivideByTwo(int num)
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
    {
        throw gcnew ArgumentException("Number must be even", "num");
    }
    // num is even, return half of its value.
    return num / 2;
}

static int DivideByTwo(int num)
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
        throw new ArgumentException("Number must be even", "num");

    // num is even, return half of its value.
    return num / 2;
}

let divideByTwo num =
    // If num is an odd number, raise an ArgumentException.
    if num % 2 = 1 then
        raise (ArgumentException("num", "Number must be even"))

    // num is even, return half of its value.
    num / 2;

Remarques

Ce constructeur initialise la Message propriété du nouveau instance à l’aide de la valeur du message paramètre . Le contenu du paramètre message doit être compréhensible par les utilisateurs. L'appelant de ce constructeur est requis pour vérifier que cette chaîne a été localisée pour la culture système actuelle.

Ce constructeur initialise la ParamName propriété du nouveau instance à l’aide de paramName. Le contenu de paramName doit être compréhensible par les utilisateurs.

Le tableau suivant affiche les valeurs de propriété initiales pour une instance de ArgumentException.

Propriété	Value
Message	Chaîne du message d'erreur.
ParamName	Chaîne de nom de paramètre.

ArgumentException(String, String, Exception)

Source:

ArgumentException.cs

Initialise une nouvelle instance de la classe ArgumentException avec un message d’erreur spécifié, le nom du paramètre et une référence à l’exception interne ayant provoqué cette exception.

public:
 ArgumentException(System::String ^ message, System::String ^ paramName, Exception ^ innerException);

public ArgumentException (string? message, string? paramName, Exception? innerException);

new ArgumentException : string * string * Exception -> ArgumentException

Public Sub New (message As String, paramName As String, innerException As Exception)

Paramètres

message

String

Message d'erreur qui explique la raison de l'exception.

paramName

String

Nom du paramètre ayant provoqué l’exception actuelle.

innerException

Exception

Exception ayant provoqué l'exception actuelle. Si le paramètre innerException n'est pas une référence null, l'exception actuelle est levée dans un bloc catch qui gère l'exception interne.

Remarques

Ce constructeur initialise la Message propriété du nouveau instance à l’aide de la valeur du message paramètre . Le contenu du paramètre message doit être compréhensible par les utilisateurs. L'appelant de ce constructeur est requis pour vérifier que cette chaîne a été localisée pour la culture système actuelle.

Ce constructeur initialise la ParamName propriété du nouveau instance à l’aide de paramName. Le contenu de paramName doit être compréhensible par les utilisateurs.

Une exception levée en conséquence directe d'une exception précédente doit contenir une référence à celle-ci dans la propriété InnerException. La propriété InnerException retourne la valeur passée au constructeur ou la valeur null si la propriété InnerException ne fournit pas la valeur d'exception interne au constructeur.

Le tableau suivant affiche les valeurs de propriété initiales pour une instance de ArgumentException.

Propriété	Value
InnerException	La référence à l'exception interne.
Message	Chaîne du message d'erreur localisé.
ParamName	Chaîne de nom de paramètre.

Voir aussi

• Exception
• Gestion et levée des exceptions