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

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

Referenz

Weitere Ressourcen