Freigeben über


ArgumentOutOfRangeException Konstruktoren

Definition

Initialisiert eine neue Instanz der ArgumentOutOfRangeException-Klasse.

Überlädt

ArgumentOutOfRangeException()

Initialisiert eine neue Instanz der ArgumentOutOfRangeException-Klasse.

ArgumentOutOfRangeException(String)

Initialisiert eine neue Instanz der ArgumentOutOfRangeException-Klasse mit dem Namen des Parameters, der diese Ausnahme auslöst.

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)
Veraltet.

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

ArgumentOutOfRangeException(String, Exception)

Initialisiert eine neue Instanz der ArgumentOutOfRangeException-Klasse mit einer angegebenen Fehlermeldung und der Ausnahme, die diese Ausnahme ausgelöst hat.

ArgumentOutOfRangeException(String, String)

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

ArgumentOutOfRangeException(String, Object, String)

Initialisiert eine neue Instanz der ArgumentOutOfRangeException-Klasse mit einer angegebenen Fehlermeldung, dem Namen des Parameters und dem Wert des Arguments und einer angegebenen Fehlermeldung.

ArgumentOutOfRangeException()

Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs

Initialisiert eine neue Instanz der ArgumentOutOfRangeException-Klasse.

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

Hinweise

Dieser Konstruktor initialisiert die Message -Eigenschaft des neuen instance zu einer vom System bereitgestellten Nachricht, die den Fehler beschreibt, z. B. "Nichtnegative Zahl erforderlich". Diese Nachricht berücksichtigt die aktuelle Systemkultur.

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

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

Gilt für:

ArgumentOutOfRangeException(String)

Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs

Initialisiert eine neue Instanz der ArgumentOutOfRangeException-Klasse mit dem Namen des Parameters, der diese Ausnahme auslöst.

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

Parameter

paramName
String

Der Name des Parameters, der die Ausnahme verursacht hat.

Hinweise

Dieser Konstruktor initialisiert die Message -Eigenschaft des neuen instance zu einer vom System bereitgestellten Nachricht, die den Fehler beschreibt, z. B. "Nichtnegative Zahl erforderlich". Diese Nachricht berücksichtigt die aktuelle Systemkultur.

Dieser Konstruktor initialisiert die ParamName-Eigenschaft der neuen Instanz unter Verwendung des paramName-Parameters. Der Inhalt der paramName soll in verständlicher Sprache gehalten sein.

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

Eigenschaft Wert
InnerException Ein NULL-Verweis (Nothing in Visual Basic).
Message Die leere Zeichenfolge ("").
ParamName Die Parameternamenzeichenfolge.

Gilt für:

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)

Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs

Achtung

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

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

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

Parameter

info
SerializationInfo

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

context
StreamingContext

Ein Objekt, das die Quelle oder das Ziel der serialisierten Daten beschreibt.

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:

ArgumentOutOfRangeException(String, Exception)

Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs

Initialisiert eine neue Instanz der ArgumentOutOfRangeException-Klasse mit einer angegebenen Fehlermeldung und der Ausnahme, die diese Ausnahme ausgelöst hat.

public:
 ArgumentOutOfRangeException(System::String ^ message, Exception ^ innerException);
public ArgumentOutOfRangeException (string message, Exception innerException);
public ArgumentOutOfRangeException (string? message, Exception? innerException);
new ArgumentOutOfRangeException : string * Exception -> ArgumentOutOfRangeException
Public Sub New (message As String, innerException As Exception)

Parameter

message
String

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

innerException
Exception

Die Ausnahme, die die aktuelle Ausnahme verursacht hat, oder ein Nullverweis (Nothing in Visual Basic), wenn keine innere Ausnahme angegeben ist.

Gilt für:

ArgumentOutOfRangeException(String, String)

Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs

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

public:
 ArgumentOutOfRangeException(System::String ^ paramName, System::String ^ message);
public ArgumentOutOfRangeException (string paramName, string message);
public ArgumentOutOfRangeException (string? paramName, string? message);
new ArgumentOutOfRangeException : string * string -> ArgumentOutOfRangeException
Public Sub New (paramName As String, message As String)

Parameter

paramName
String

Der Name des Parameters, der die Ausnahme verursacht hat.

message
String

Die Meldung, in der der Fehler beschrieben wird.

Hinweise

Dieser Konstruktor initialisiert die Message Eigenschaft des neuen instance mit dem Wert 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 der neuen Instanz unter Verwendung des paramName-Parameters. Der Inhalt der paramName soll in verständlicher Sprache gehalten sein.

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

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

Gilt für:

ArgumentOutOfRangeException(String, Object, String)

Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs
Quelle:
ArgumentOutOfRangeException.cs

Initialisiert eine neue Instanz der ArgumentOutOfRangeException-Klasse mit einer angegebenen Fehlermeldung, dem Namen des Parameters und dem Wert des Arguments und einer angegebenen Fehlermeldung.

public:
 ArgumentOutOfRangeException(System::String ^ paramName, System::Object ^ actualValue, System::String ^ message);
public ArgumentOutOfRangeException (string paramName, object actualValue, string message);
public ArgumentOutOfRangeException (string? paramName, object? actualValue, string? message);
new ArgumentOutOfRangeException : string * obj * string -> ArgumentOutOfRangeException
Public Sub New (paramName As String, actualValue As Object, message As String)

Parameter

paramName
String

Der Name des Parameters, der die Ausnahme verursacht hat.

actualValue
Object

Der Wert des Arguments, das diese Ausnahme auslöst.

message
String

Die Meldung, in der der Fehler beschrieben wird.

Hinweise

Dieser Konstruktor initialisiert die ParamName Eigenschaft des neuen instance mithilfe des paramName Parameters, der ActualValue -Eigenschaft mit dem actualValue -Parameter und der Message -Eigenschaft mit dem message -Parameter. Der Inhalt der paramName Parameter und message soll vom Menschen verstanden werden. Der Aufrufer dieses Konstruktors ist erforderlich, um sicherzustellen, dass diese Zeichenfolgen für die aktuelle Systemkultur lokalisiert wurden.

Der actualValue Parameter wird in der .NET-Klassenbibliothek nicht verwendet. Apps können jedoch die ActualValue -Eigenschaft verwenden, um den verfügbaren Argumentwert abzurufen.

Der actualValue -Parameter enthält den ungültigen Wert, der an die -Methode übergeben wurde und bewirkt hat, dass diese Ausnahme ausgelöst wurde. Dieser Wert wird in der ActualValue -Eigenschaft gespeichert, und seine Zeichenfolgendarstellung wird an die Nachrichtenzeichenfolge in der Message -Eigenschaft angefügt.

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

Eigenschaft Wert
ActualValue Der Argumentwert.
InnerException Der NULL-Verweis (Nothing in Visual Basic).
Message Die Zeichenfolge der Fehlermeldung.
ParamName Die Parameternamenzeichenfolge.

Gilt für: