Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

ArgumentOutOfRangeException (Clase)

Excepción que se produce cuando el valor de un argumento se encuentra fuera del intervalo de valores permitido definido por el método invocado.

System.Object
  System.Exception
    System.SystemException
      System.ArgumentException
        System.ArgumentOutOfRangeException

Espacio de nombres:  System
Ensamblado:  mscorlib (en mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ArgumentOutOfRangeException : ArgumentException, 
	ISerializable

El tipo ArgumentOutOfRangeException expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifArgumentOutOfRangeException()Inicializa una nueva instancia de la clase ArgumentOutOfRangeException.
Método públicoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifArgumentOutOfRangeException(String)Inicializa una nueva instancia de la clase ArgumentOutOfRangeException con el nombre del parámetro que provoca esta excepción.
Método protegidoArgumentOutOfRangeException(SerializationInfo, StreamingContext)Inicializa una nueva instancia de la clase ArgumentOutOfRangeException con datos serializados.
Método público8xt94y6e.PortableClassLibrary(es-es,VS.100).gifArgumentOutOfRangeException(String, Exception)Inicializa una nueva instancia de la clase ArgumentOutOfRangeException con el mensaje de error especificado y la excepción que representa la causa de esta excepción.
Método públicoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifArgumentOutOfRangeException(String, String)Inicializa una nueva instancia de la clase ArgumentOutOfRangeException con un mensaje de error especificado y el nombre del parámetro que causa esta excepción.
Método públicoArgumentOutOfRangeException(String, Object, String)Inicializa una nueva instancia de la clase ArgumentOutOfRangeException con un mensaje de error especificado, el nombre del parámetro y el valor del argumento.
Arriba

  NombreDescripción
Propiedad públicaActualValueObtiene el valor del argumento que causa esta excepción.
Propiedad públicaDataObtiene una colección de pares de clave y valor que proporcionan información adicional definida por el usuario acerca de la excepción. (Se hereda de Exception).
Propiedad públicaHelpLinkObtiene o establece un vínculo al archivo de ayuda asociado a esta excepción. (Se hereda de Exception).
Propiedad protegidaCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifHResultObtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica. (Se hereda de Exception).
Propiedad públicaCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifInnerExceptionObtiene la instancia Exception que produjo la excepción actual. (Se hereda de Exception).
Propiedad públicaCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifMessageObtiene el mensaje de error y la representación de cadena del valor del argumento no válido. Si el valor del argumento es nulo, obtiene sólo el mensaje de error. (Invalida a ArgumentException.Message).

En XNA Framework 3.0, este miembro se hereda de Exception.Message.


En  , este miembro se hereda de Exception.Message.
Propiedad públicaParamNameObtiene el nombre del parámetro que causa esta excepción. (Se hereda de ArgumentException).
Propiedad públicaSourceDevuelve o establece el nombre de la aplicación o del objeto que generó el error. (Se hereda de Exception).
Propiedad públicaCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifStackTraceObtiene una representación de cadena de los marcos inmediatos en la pila de llamadas. (Se hereda de Exception).
Propiedad públicaTargetSiteObtiene el método que produjo la excepción actual. (Se hereda de Exception).
Arriba

  NombreDescripción
Método públicoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegidoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Se hereda de Object).
Método públicoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifGetBaseExceptionCuando se reemplaza en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores. (Se hereda de Exception).
Método públicoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetObjectDataEstablece el objeto SerializationInfo con el valor del argumento no válido e información adicional de la excepción. (Invalida a ArgumentException.GetObjectData(SerializationInfo, StreamingContext)).
Método públicoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifGetTypeObtiene el tipo en tiempo de ejecución de la instancia actual. (Se hereda de Exception).

En XNA Framework 3.0, este miembro se hereda de Object.GetType().


En  , este miembro se hereda de Object.GetType().
Método protegidoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoCompatible con XNA Framework8xt94y6e.PortableClassLibrary(es-es,VS.100).gifToStringCrea y devuelve una representación de cadena de la excepción actual. (Se hereda de Exception).
Arriba

  NombreDescripción
Evento protegidoSerializeObjectStateSe produce cuando se serializa una excepción para crear un objeto de estados de excepción que contiene datos serializados sobre la excepción. (Se hereda de Exception).
Arriba

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:

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

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Compatible con:

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

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Mostrar: