ArgumentOutOfRangeException-Klasse

ArgumentOutOfRangeException wird ausgelöst, wenn eine Methode aufgerufen wird und mindestens eines der übergebenen Argumente nicht null ist und keinen gültigen Wert enthält.

ArgumentOutOfRangeException wird häufig von folgenden Klassen verwendet:

• Klassen im System.Collections-Namespace und System.IO-Namespace.

• Die Array-Klasse.

ArgumentOutOfRangeException verhält sich genauso wie ArgumentException. Diese Ausnahme wurde bereitgestellt, damit Anwendungsprogramme zwischen Ausnahmen unterscheiden können, die durch NULL-Argumente verursacht wurden, und solchen, die durch ungültige Argumente verursacht wurden, die nicht null sind. Weitere Informationen zu Fehlern, die durch NULL-Argumente verursacht werden, finden Sie unter ArgumentNullException.

ArgumentOutOfRangeException verwendet HRESULT COR_E_ARGUMENTOUTOFRANGE mit dem Wert 0x80131502.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von ArgumentOutOfRangeException finden Sie unter ArgumentOutOfRangeException-Konstruktoren.

Im folgenden Beispiel wird eine Klasse definiert, die Informationen über einen eingeladenen Gast enthält. Wenn der Gast jünger als 21 ist, wird eine ArgumentOutOfRangeException-Ausnahme ausgelöst.

using System;

class Program
{
    static void Main(string[] args)
    {
        try
        {
            Guest guest1 = new Guest("Ben", "Miller", 17);
            Console.WriteLine(guest1.GuestInfo());
        }
        catch (ArgumentOutOfRangeException outOfRange)
        {

            Console.WriteLine("Error: {0}", outOfRange.Message);
        }
    }
}

class Guest
{
    private string FirstName;
    private string LastName;
    private int Age;

    public Guest(string fName, string lName, int age)
    {
        FirstName = fName;
        LastName = lName;
        if (age < 21)
            throw new ArgumentOutOfRangeException("age","All guests must be 21-years-old or older.");
        else
            Age = age;
    }

    public string GuestInfo()
    {
        string gInfo = FirstName + " " + LastName + ", " + Age.ToString();
        return(gInfo);
    }
}

.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