Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
ArgumentException-Klasse
Die Ausnahme, die ausgelöst wird, wenn eines der Argumente für eine Methode ungültig ist.
System.Exception
System.SystemException
System.ArgumentException
Weitere Informationen...
Assembly: mscorlib (in mscorlib.dll)
Der ArgumentException-Typ macht die folgenden Member verfügbar.
| 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) | 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. |
| Name | Beschreibung | |
|---|---|---|
|
Data | Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zu der Ausnahme bereitstellen. (Von Exception geerbt.) |
|
HelpLink | Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Von Exception geerbt.) |
|
HResult | Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Von Exception geerbt.) |
|
InnerException | Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursachte. (Von Exception geerbt.) |
|
Message |
Ruft die Fehlermeldung und den Parameternamen oder nur die Fehlermeldung ab, wenn kein Parametername festgelegt ist.
(Überschreibt Exception.Message.) In XNA Framework 3.0 wird dieser Member von Exception.Message. In wird dieser Member von Exception.Message. |
|
ParamName | Ruft den Namen des Parameters ab, der diese Ausnahme auslöst. |
|
Source | Gibt den Namen der Anwendung oder des Objekts zurück, das den Fehler verursacht hat, oder legt diesen fest. (Von Exception geerbt.) |
|
StackTrace | Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Von Exception geerbt.) |
|
TargetSite | Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Von Exception geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
Finalize | Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.) |
|
GetBaseException | Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist. (Von Exception geerbt.) |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetObjectData | Legt das SerializationInfo-Objekt mit dem Parameternamen und zusätzlichen Informationen zur Ausnahme fest. (Überschreibt Exception.GetObjectData(SerializationInfo, StreamingContext).) |
|
GetType |
Ruft den Laufzeittyp der aktuellen Instanz ab.
(Von Exception geerbt.) In XNA Framework 3.0 wird dieser Member von Object.GetType(). In wird dieser Member von Object.GetType(). |
|
MemberwiseClone | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
ToString | Erstellt eine Zeichenfolgenentsprechung der aktuellen Ausnahme und gibt diese zurück. (Von Exception geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
SerializeObjectState | Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt zu erstellen, das serialisierte Daten für die Ausnahme enthält. (Von Exception geerbt.) |
ArgumentException wird ausgelöst, wenn eine Methode aufgerufen wird und mindestens eines der übergebenen Argumente nicht der Parameterspezifikation der aufgerufenen Methode entspricht. Allen Instanzen von ArgumentException muss eine aussagekräftige Fehlermeldung zugeordnet sein, in der sowohl das ungültige Argument als auch der erwartete Wertebereich für das Argument beschrieben sind.
Die primären von ArgumentException abgeleiteten Klassen sind ArgumentNullException und ArgumentOutOfRangeException. Diese abgeleiteten Klassen müssen anstelle von ArgumentException verwendet werden. Ausgenommen hiervon sind Situationen, in denen die Verwendung einer abgeleiteten Klasse unzulässig ist. Ausnahmen müssen z. B. in folgenden Situationen ausgelöst werden:
-
ArgumentNullException, wenn null an eine Methode übergeben wird, für die dies kein gültiges Argument ist.
-
ArgumentOutOfRangeException, wenn der Wert eines Arguments nicht im zulässigen Wertebereich liegt; z. B. wenn beim Erstellen von DateTime der Wert 46 als Argument für den Monat übergeben wird.
Wenn die aufgerufene Methode keine Argumente benötigt oder der vorliegende Fehler nicht die Argumente betrifft, wird InvalidOperationException verwendet.
ArgumentException verwendet HRESULT COR_E_ARGUMENT mit dem Wert 0x80070057.
Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von ArgumentException finden Sie unter ArgumentException-Konstruktoren.
Im folgenden Beispiel wird das Auslösen und Abfangen einer ArgumentException veranschaulicht.
using System; public sealed class App { static void Main() { // ArgumentException is not thrown because 10 is an even number. Console.WriteLine("10 divided by 2 is {0}", DivideByTwo(10)); try { // ArgumentException is thrown because 7 is not an even number. Console.WriteLine("7 divided by 2 is {0}", DivideByTwo(7)); } catch (ArgumentException) { // Show the user that 7 cannot be divided by 2. Console.WriteLine("7 is not divided by 2 integrally."); } } 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; } } // This code produces the following output. // // 10 divided by 2 is 5 // 7 is not divided by 2 integrally.
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
System.Exception
System.SystemException
System.ArgumentException
System.ArgumentNullException
System.ArgumentOutOfRangeException
System.ComponentModel.InvalidAsynchronousStateException
System.ComponentModel.InvalidEnumArgumentException
System.DuplicateWaitObjectException
System.Globalization.CultureNotFoundException
System.IO.Log.ReservationNotFoundException
System.Text.DecoderFallbackException
System.Text.EncoderFallbackException