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 qui est la cause de 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 qui provoque 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 qui est la cause de 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 propriété Message 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 actuelle.

Le tableau suivant présente les valeurs de propriété initiales d’une instance de ArgumentException.

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

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 propriété Message 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 actuelle.

Le tableau suivant présente les valeurs de propriété initiales d’une instance de ArgumentException.

Propriété	Valeur
InnerException	Référence Null (Nothing en Visual Basic).
Message	Chaîne de 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 d’objet sérialisées.

context

StreamingContext

Informations contextuelles sur la source ou la destination.

Attributs

ObsoleteAttribute

Remarques

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

Voir aussi

• de 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 qui est la cause de 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 qui est la cause de 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 propriété Message de la nouvelle instance à l’aide de la valeur du paramètre message. Le contenu du paramètre message est destiné à être compris par les humains. L’appelant de ce constructeur est requis pour s’assurer 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 inclure une référence à l’exception précédente dans la propriété InnerException. La propriété InnerException retourne la même valeur que celle passée dans le constructeur, ou null si la propriété InnerException ne fournit pas la valeur d’exception interne au constructeur.

Le tableau suivant présente les valeurs de propriété initiales d’une instance de ArgumentException.

Propriété	Valeur
InnerException	Référence d’exception interne.
Message	Chaîne de message d’erreur localisée.

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 qui provoque 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 qui a provoqué l’exception actuelle.

Exemples

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

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 propriété Message de la nouvelle instance à l’aide de la valeur du paramètre message. Le contenu du paramètre message est destiné à être compris par les humains. L’appelant de ce constructeur est requis pour s’assurer que cette chaîne a été localisée pour la culture système actuelle.

Ce constructeur initialise la propriété ParamName de la nouvelle instance à l’aide de paramName. Le contenu de paramName est destiné à être compris par les humains.

Le tableau suivant présente les valeurs de propriété initiales d’une instance de ArgumentException.

Propriété	Valeur
Message	Chaîne de 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 qui est la cause de 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 qui a provoqué l’exception actuelle.

innerException

Exception

Exception qui est la cause de 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 propriété Message de la nouvelle instance à l’aide de la valeur du paramètre message. Le contenu du paramètre message est destiné à être compris par les humains. L’appelant de ce constructeur est requis pour s’assurer que cette chaîne a été localisée pour la culture système actuelle.

Ce constructeur initialise la propriété ParamName de la nouvelle instance à l’aide de paramName. Le contenu de paramName est destiné à être compris par les humains.

Une exception levée en conséquence directe d’une exception précédente doit inclure une référence à l’exception précédente dans la propriété InnerException. La propriété InnerException retourne la même valeur que celle passée dans le constructeur, ou null si la propriété InnerException ne fournit pas la valeur d’exception interne au constructeur.

Le tableau suivant présente les valeurs de propriété initiales d’une instance de ArgumentException.

Propriété	Valeur
InnerException	Référence d’exception interne.
Message	Chaîne de message d’erreur localisée.
ParamName	Chaîne de nom de paramètre.

Voir aussi

• Exception
• gestion et levée des exceptions