ArgumentException Constructeurs

Définition

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)

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()

Initialise une nouvelle instance de la classe ArgumentException.

public:
 ArgumentException();
public ArgumentException ();
Public Sub New ()

Remarques

Ce constructeur initialise la Message propriété de la nouvelle instance dans 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 en cours.

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é.

S’applique à

ArgumentException(String)

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

public:
 ArgumentException(System::String ^ message);
public ArgumentException (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é de la nouvelle instance dans 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 en cours.

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.

S’applique à

ArgumentException(SerializationInfo, StreamingContext)

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);
protected ArgumentException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
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.

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’applique à

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.

public:
 ArgumentException(System::String ^ message, Exception ^ innerException);
public ArgumentException (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é de la nouvelle 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

S’applique à

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.

public:
 ArgumentException(System::String ^ message, System::String ^ paramName);
public ArgumentException (string message, 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é de la nouvelle 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é de la nouvelle instance à l’aide paramNamede . 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.

S’applique à

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.

public:
 ArgumentException(System::String ^ message, System::String ^ paramName, Exception ^ innerException);
public ArgumentException (string message, 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é de la nouvelle 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é de la nouvelle instance à l’aide paramNamede . 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

S’applique à