ArgumentOutOfRangeException (Clase)

Se produce ArgumentOutOfRangeException cuando se llama a un método y al menos uno de los argumentos pasados al mismo no es null y no contiene un valor válido.

ArgumentOutOfRangeException suele ser utilizada por:

• Clases de los espacios de nombres System.Collections y System.IO.

• Clase Array

ArgumentOutOfRangeException se comporta idénticamente a ArgumentException. Se proporciona para que el código de la aplicación pueda realizar diferencias entre excepciones provocadas por argumentos no válidos que no son null y excepciones provocadas por argumentos que son null. En el caso de errores provocados por argumentos que son null, vea ArgumentNullException.

ArgumentOutOfRangeException utiliza HRESULT COR_E_ARGUMENTOUTOFRANGE, que tiene el valor 0x80131502.

Para obtener una lista con los valores iniciales de las propiedades de una instancia de ArgumentOutOfRangeException, vea los constructores ArgumentOutOfRangeException.

En el ejemplo siguiente se define una clase para contener información sobre un invitado. Si el invitado es menor de 21 años, se produce una excepción ArgumentOutOfRangeException.

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 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos