ArgumentException-Klasse

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.

.NET Framework

.NET Framework Client Profile

Portable Klassenbibliothek

.NET für Windows Store-Apps

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen