ArgumentException Konstruktoren

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Initialisiert eine neue Instanz der ArgumentException-Klasse.

Überlädt

Name	Beschreibung
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 die Ursache dieser Ausnahme ist.
ArgumentException(String, String)	Initialisiert eine neue Instanz der ArgumentException Klasse mit einer angegebenen Fehlermeldung und dem Namen des Parameters, der diese Ausnahme verursacht.
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 die Ursache dieser Ausnahme ist.

ArgumentException()

Quelle:

ArgumentException.cs

Initialisiert eine neue Instanz der ArgumentException-Klasse.

public:
 ArgumentException();

public ArgumentException();

Public Sub New ()

Hinweise

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

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz von ArgumentException.

Eigentum	Wert
InnerException	Ein Nullverweis (Nothing in Visual Basic).
Message	Die lokalisierte Fehlermeldungszeichenfolge.

ArgumentException(String)

Quelle:

ArgumentException.cs

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

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

public ArgumentException(string? message);

new ArgumentException : string -> ArgumentException

Public Sub New (message As String)

Parameter

message

String

Die Fehlermeldung, die den Grund für die Ausnahme erklärt.

Hinweise

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

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz von ArgumentException.

Eigentum	Wert
InnerException	Ein Nullverweis (Nothing in Visual Basic).
Message	Die Fehlermeldungszeichenfolge.

ArgumentException(SerializationInfo, StreamingContext)

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

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

Parameter

info

SerializationInfo

Das Objekt, das die serialisierten Objektdaten enthält.

context

StreamingContext

Die kontextbezogenen Informationen zur Quelle oder zum Ziel.

Attribute

ObsoleteAttribute

Hinweise

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

Weitere Informationen

• XML- und SOAP-Serialisierung

ArgumentException(String, Exception)

Quelle:

ArgumentException.cs

Initialisiert eine neue Instanz der ArgumentException Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die die Ursache dieser Ausnahme ist.

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)

Parameter

message

String

Die Fehlermeldung, die den Grund für die Ausnahme erklärt.

innerException

Exception

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

Hinweise

Dieser Konstruktor initialisiert die Message Eigenschaft der neuen Instanz mithilfe des Werts des message Parameters. Der Inhalt des message Parameters soll vom Menschen verstanden werden. 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 vorherigen Ausnahme ausgelöst wird, sollte einen Verweis auf die vorherige Ausnahme in der InnerException Eigenschaft enthalten. Die InnerException Eigenschaft gibt denselben Wert zurück, der an den Konstruktor übergeben wird, oder null wenn die InnerException Eigenschaft den inneren Ausnahmewert nicht für den Konstruktor angibt.

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz von ArgumentException.

Eigentum	Wert
InnerException	Der interne Ausnahmeverweis.
Message	Die lokalisierte Fehlermeldungszeichenfolge.

Weitere Informationen

• Exception
• Behandeln und Auslösen von Ausnahmen

ArgumentException(String, String)

Quelle:

ArgumentException.cs

Initialisiert eine neue Instanz der ArgumentException Klasse mit einer angegebenen Fehlermeldung und dem Namen des Parameters, der diese Ausnahme verursacht.

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)

Parameter

message

String

Die Fehlermeldung, die den Grund für die Ausnahme erklärt.

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.

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 der neuen Instanz mithilfe des Werts des message Parameters. Der Inhalt des message Parameters soll vom Menschen verstanden werden. Der Aufrufer dieses Konstruktors ist erforderlich, um sicherzustellen, dass diese Zeichenfolge für die aktuelle Systemkultur lokalisiert wurde.

Dieser Konstruktor initialisiert die ParamName Eigenschaft der neuen Instanz mithilfe paramNamevon . Der Inhalt soll paramName von Menschen verstanden werden.

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz von ArgumentException.

Eigentum	Wert
Message	Die Fehlermeldungszeichenfolge.
ParamName	Die Parameternamenzeichenfolge.

ArgumentException(String, String, Exception)

Quelle:

ArgumentException.cs

Initialisiert eine neue Instanz der ArgumentException Klasse mit einer angegebenen Fehlermeldung, dem Parameternamen und einem Verweis auf die innere Ausnahme, die die Ursache dieser Ausnahme ist.

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)

Parameter

message

String

Die Fehlermeldung, die den Grund für die Ausnahme erklärt.

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 Nullverweis ist, wird die aktuelle Ausnahme in einem catch Block ausgelöst, der die innere Ausnahme behandelt.

Hinweise

Dieser Konstruktor initialisiert die Message Eigenschaft der neuen Instanz mithilfe des Werts des message Parameters. Der Inhalt des message Parameters soll vom Menschen verstanden werden. Der Aufrufer dieses Konstruktors ist erforderlich, um sicherzustellen, dass diese Zeichenfolge für die aktuelle Systemkultur lokalisiert wurde.

Dieser Konstruktor initialisiert die ParamName Eigenschaft der neuen Instanz mithilfe paramNamevon . Der Inhalt soll paramName von Menschen verstanden werden.

Eine Ausnahme, die als direktes Ergebnis einer vorherigen Ausnahme ausgelöst wird, sollte einen Verweis auf die vorherige Ausnahme in der InnerException Eigenschaft enthalten. Die InnerException Eigenschaft gibt denselben Wert zurück, der an den Konstruktor übergeben wird, oder null wenn die InnerException Eigenschaft den inneren Ausnahmewert nicht für den Konstruktor angibt.

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz von ArgumentException.

Eigentum	Wert
InnerException	Der interne Ausnahmeverweis.
Message	Die lokalisierte Fehlermeldungszeichenfolge.
ParamName	Die Parameternamenzeichenfolge.

Weitere Informationen

• Exception
• Behandeln und Auslösen von Ausnahmen