Lire en anglais

Partager via


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)
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
Source:
ArgumentException.cs
Source:
ArgumentException.cs

Initialise une nouvelle instance de la classe ArgumentException.

C#
public ArgumentException ();

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.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ArgumentException(String)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
Source:
ArgumentException.cs

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

C#
public ArgumentException (string message);
C#
public ArgumentException (string? message);

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.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ArgumentException(SerializationInfo, StreamingContext)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
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.

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

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

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

S’applique à

.NET 9 et autres versions
Produit Versions (Obsolète)
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 (8, 9)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ArgumentException(String, Exception)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
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.

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

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

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ArgumentException(String, String)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
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.

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

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.

C#
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;
}

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.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ArgumentException(String, String, Exception)

Source:
ArgumentException.cs
Source:
ArgumentException.cs
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.

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

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

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0