ArgumentException Konstruktoren

Definition

Namespace:

System

Assembly:

System.Runtime.dll

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

Source:

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.

ArgumentException(String)

Source:

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

ArgumentException(SerializationInfo, StreamingContext)

Source:

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 Daten des serialisierten Objekts enthält.

context

StreamingContext

Die Kontextinformationen zur Quelle bzw. zum Ziel.

Attribute

ObsoleteAttribute

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

• XML- und SOAP-Serialisierung

ArgumentException(String, Exception)

Source:

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

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

• Exception
• Behandeln und Auslösen von Ausnahmen

ArgumentException(String, String)

Source:

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

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.

ArgumentException(String, String, Exception)

Source:

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

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

• Exception
• Behandeln und Auslösen von Ausnahmen