Freigeben über


ArgumentException Konstruktoren

Definition

Initialisiert eine neue Instanz der ArgumentException-Klasse.

Überlädt

ArgumentException()

Initialisiert eine neue Instanz der ArgumentException-Klasse.

ArgumentException(String)

Initialisiert eine neue Instanz der ArgumentException-Klasse mit einer angegebenen Fehlermeldung.

ArgumentException(SerializationInfo, StreamingContext)
Veraltet.

Initialisiert eine neue Instanz der ArgumentException-Klasse mit serialisierten Daten.

ArgumentException(String, Exception)

Initialisiert eine neue Instanz der ArgumentException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.

ArgumentException(String, String)

Initialisiert eine neue Instanz der ArgumentException-Klasse mit einer angegebenen Fehlermeldung und dem Namen des Parameters, der die Ausnahme auslöst.

ArgumentException(String, String, Exception)

Initialisiert eine neue Instanz der ArgumentException-Klasse mit einer angegebenen Fehlermeldung, dem Parameternamen und einem Verweis auf die innere Ausnahme, die diese Ausnahme verursacht hat.

ArgumentException()

Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs

Initialisiert eine neue Instanz der ArgumentException-Klasse.

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

Hinweise

Dieser Konstruktor initialisiert die Message -Eigenschaft des neuen instance in einer vom System bereitgestellten Meldung, die den Fehler beschreibt, z. B. "Ein ungültiges Argument wurde angegeben.". Diese Nachricht berücksichtigt die aktuelle Systemkultur.

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine ArgumentException-Instanz aufgeführt.

Eigenschaft Wert
InnerException Ein NULL-Verweis (Nothing in Visual Basic).
Message Die lokalisierte Zeichenfolge mit der Fehlermeldung.

Gilt für:

ArgumentException(String)

Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs

Initialisiert eine neue Instanz der ArgumentException-Klasse mit einer angegebenen Fehlermeldung.

public:
 ArgumentException(System::String ^ message);
public ArgumentException (string message);
public ArgumentException (string? message);
new ArgumentException : string -> ArgumentException
Public Sub New (message As String)

Parameter

message
String

Die Fehlermeldung, in der die Ursache der Ausnahme erklärt wird.

Hinweise

Dieser Konstruktor initialisiert die Message -Eigenschaft des neuen instance in einer vom System bereitgestellten Meldung, die den Fehler beschreibt, z. B. "Ein ungültiges Argument wurde angegeben.". Diese Nachricht berücksichtigt die aktuelle Systemkultur.

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine ArgumentException-Instanz aufgeführt.

Eigenschaft Wert
InnerException Ein NULL-Verweis (Nothing in Visual Basic).
Message Die Zeichenfolge der Fehlermeldung.

Gilt für:

ArgumentException(SerializationInfo, StreamingContext)

Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs

Achtung

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

Initialisiert eine neue Instanz der ArgumentException-Klasse mit serialisierten Daten.

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

Parameter

info
SerializationInfo

Das Objekt, das die Daten des serialisierten Objekts enthält.

context
StreamingContext

Die Kontextinformationen zur Quelle bzw. zum Ziel.

Attribute

Hinweise

Dieser Konstruktor wird während der Deserialisierung aufgerufen, um das über einen Datenstrom übertragene Ausnahmeobjekt wieder zusammenzusetzen. Weitere Informationen finden Sie unter XML- und SOAP-Serialisierung.

Weitere Informationen

Gilt für:

ArgumentException(String, Exception)

Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs

Initialisiert eine neue Instanz der ArgumentException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.

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)

Parameter

message
String

Die Fehlermeldung, in der die Ursache der Ausnahme erklärt wird.

innerException
Exception

Die Ausnahme, die die Ursache der aktuellen Ausnahme ist. Wenn der innerException-Parameter kein NULL-Verweis ist, wird die aktuelle Ausnahme in einem catch-Block ausgelöst, der die innere Ausnahme behandelt.

Hinweise

Dieser Konstruktor initialisiert die Message -Eigenschaft des neuen instance unter Verwendung des Werts des message Parameters. Der Inhalt des message-Parameters sollte für Personen verständlich sein. Der Aufrufer dieses Konstruktors ist erforderlich, um sicherzustellen, dass diese Zeichenfolge für die aktuelle Systemkultur lokalisiert wurde.

Eine Ausnahme, die als direktes Ergebnis einer vorhergehenden Ausnahme ausgelöst wird, muss in der InnerException-Eigenschaft über einen Verweis auf die vorhergehende Ausnahme verfügen. Die InnerException-Eigenschaft gibt den gleichen Wert zurück, der an den Konstruktor übergeben wird, oder null, wenn die InnerException-Eigenschaft den Wert der inneren Ausnahme nicht an den Konstruktor übergibt.

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine ArgumentException-Instanz aufgeführt.

Eigenschaft Wert
InnerException Der Verweis auf die interne Ausnahme.
Message Die lokalisierte Zeichenfolge mit der Fehlermeldung.

Weitere Informationen

Gilt für:

ArgumentException(String, String)

Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs

Initialisiert eine neue Instanz der ArgumentException-Klasse mit einer angegebenen Fehlermeldung und dem Namen des Parameters, der die Ausnahme auslöst.

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)

Parameter

message
String

Die Fehlermeldung, in der die Ursache der Ausnahme erklärt wird.

paramName
String

Der Name des Parameters, der die aktuelle Ausnahme verursacht hat.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der ArgumentException Konstruktor aufgerufen wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ArgumentException-Klasse bereitgestellt wird.

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;

Hinweise

Dieser Konstruktor initialisiert die Message -Eigenschaft des neuen instance unter Verwendung des Werts des message Parameters. Der Inhalt des message-Parameters sollte für Personen verständlich sein. Der Aufrufer dieses Konstruktors ist erforderlich, um sicherzustellen, dass diese Zeichenfolge für die aktuelle Systemkultur lokalisiert wurde.

Dieser Konstruktor initialisiert die ParamName -Eigenschaft des neuen instance mit paramName. Der Inhalt der paramName soll in verständlicher Sprache gehalten sein.

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine ArgumentException-Instanz aufgeführt.

Eigenschaft Wert
Message Die Zeichenfolge der Fehlermeldung.
ParamName Die Parameternamenzeichenfolge.

Gilt für:

ArgumentException(String, String, Exception)

Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs
Quelle:
ArgumentException.cs

Initialisiert eine neue Instanz der ArgumentException-Klasse mit einer angegebenen Fehlermeldung, dem Parameternamen und einem Verweis auf die innere Ausnahme, die diese Ausnahme verursacht hat.

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)

Parameter

message
String

Die Fehlermeldung, in der die Ursache der Ausnahme erklärt wird.

paramName
String

Der Name des Parameters, der die aktuelle Ausnahme verursacht hat.

innerException
Exception

Die Ausnahme, die die Ursache der aktuellen Ausnahme ist. Wenn der innerException-Parameter kein NULL-Verweis ist, wird die aktuelle Ausnahme in einem catch-Block ausgelöst, der die innere Ausnahme behandelt.

Hinweise

Dieser Konstruktor initialisiert die Message -Eigenschaft des neuen instance unter Verwendung des Werts des message Parameters. Der Inhalt des message-Parameters sollte für Personen verständlich sein. Der Aufrufer dieses Konstruktors ist erforderlich, um sicherzustellen, dass diese Zeichenfolge für die aktuelle Systemkultur lokalisiert wurde.

Dieser Konstruktor initialisiert die ParamName -Eigenschaft des neuen instance mit paramName. Der Inhalt der paramName soll in verständlicher Sprache gehalten sein.

Eine Ausnahme, die als direktes Ergebnis einer vorhergehenden Ausnahme ausgelöst wird, muss in der InnerException-Eigenschaft über einen Verweis auf die vorhergehende Ausnahme verfügen. Die InnerException-Eigenschaft gibt den gleichen Wert zurück, der an den Konstruktor übergeben wird, oder null, wenn die InnerException-Eigenschaft den Wert der inneren Ausnahme nicht an den Konstruktor übergibt.

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine ArgumentException-Instanz aufgeführt.

Eigenschaft Wert
InnerException Der Verweis auf die interne Ausnahme.
Message Die lokalisierte Zeichenfolge mit der Fehlermeldung.
ParamName Die Parameternamenzeichenfolge.

Weitere Informationen

Gilt für: