Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ArgumentException

 

Publicado: octubre de 2016

Excepción que se produce cuando no es válido uno de los argumentos proporcionados para un método.

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


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

NombreDescripción
System_CAPS_pubmethodArgumentException()

Inicializa una nueva instancia de la clase ArgumentException.

System_CAPS_protmethodArgumentException(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase ArgumentException con datos serializados.

System_CAPS_pubmethodArgumentException(String)

Inicializa una nueva instancia de la clase ArgumentException con el mensaje de error especificado.

System_CAPS_pubmethodArgumentException(String, Exception)

Inicializa una nueva instancia de la clase ArgumentException con el mensaje de error especificado y una referencia a la excepción interna que representa la causa de esta excepción.

System_CAPS_pubmethodArgumentException(String, String)

Inicializa una nueva instancia de la clase ArgumentException con un mensaje de error especificado y el nombre del parámetro que provoca esta excepción.

System_CAPS_pubmethodArgumentException(String, String, Exception)

Inicializa una nueva instancia de la clase ArgumentException con un mensaje de error especificado, el nombre del parámetro y una referencia a la excepción interna que representa la causa de esta excepción.

NombreDescripción
System_CAPS_pubpropertyData

Obtiene una colección de pares clave-valor que proporcionan más información definida por el usuario sobre la excepción.(Heredado de Exception).

System_CAPS_pubpropertyHelpLink

Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción.(Heredado de Exception).

System_CAPS_pubpropertyHResult

Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica.(Heredado de Exception).

System_CAPS_pubpropertyInnerException

Obtiene la instancia Exception que produjo la excepción actual.(Heredado de Exception).

System_CAPS_pubpropertyMessage

Obtiene el mensaje de error y el nombre del parámetro. Si no se estableció ningún nombre de parámetro, obtiene solo el mensaje de error.(Invalida Exception.Message).

System_CAPS_pubpropertyParamName

Obtiene el nombre del parámetro que causa esta excepción.

System_CAPS_pubpropertySource

Devuelve o establece el nombre de la aplicación o del objeto que generó el error.(Heredado de Exception).

System_CAPS_pubpropertyStackTrace

Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas.(Heredado de Exception).

System_CAPS_pubpropertyTargetSite

Obtiene el método que produjo la excepción actual.(Heredado de Exception).

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetBaseException()

Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores.(Heredado de Exception).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Establece el objeto SerializationInfo con el nombre del parámetro y la información adicional de la excepción.(Invalida Exception.GetObjectData(SerializationInfo, StreamingContext)).

System_CAPS_pubmethodGetType()

Obtiene el tipo en tiempo de ejecución de la instancia actual.(Heredado de Exception).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Crea y devuelve una representación de cadena de la excepción actual.(Heredado de Exception).

NombreDescripción
System_CAPS_proteventSerializeObjectState

Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción.(Heredado de Exception).

ArgumentExceptionse produce cuando se invoca un método y al menos uno de los argumentos pasados no cumple la especificación de parámetros del método llamado. El ParamName propiedad identifica el argumento no válido.

Normalmente, una ArgumentException producida por common language runtime o en otra biblioteca de clase e indica el error de desarrollador. Si se produce un ArgumentException desde el código, debe asegurarse de que la excepción Message esta propiedad incluye un mensaje de error significativo que describe el argumento no válido y el intervalo de valores para el argumento esperado.

Las principales clases derivadas de ArgumentException son ArgumentNullException y ArgumentOutOfRangeException. Estas clases derivadas deben usarse en lugar de ArgumentException, excepto en situaciones donde ninguna de las clases derivadas sea aceptable. Por ejemplo, se deberían iniciar excepciones por:

  • ArgumentNullExceptioncada vez que null se pasa a un método que no la acepta como argumento válido.

  • ArgumentOutOfRangeExceptionCuando el valor de un argumento está fuera del intervalo de valores aceptables; Por ejemplo, cuando se pasa el valor "46" como argumento del mes durante la creación de un DateTime.

Si la llamada al método no tiene ningún argumento o si el error no relacionado con los argumentos a sí mismos, a continuación, InvalidOperationException debe utilizarse.

ArgumentExceptionutiliza HRESULT COR_E_ARGUMENT, que tiene el valor 0 x 80070057.

Para obtener una lista de valores de propiedad iniciales para una instancia de ArgumentException, consulte el ArgumentException constructores.

En el ejemplo siguiente se muestra cómo producir y detectar una ArgumentException. Usa el ArgumentException.GetType(). Nombre propiedad para mostrar el nombre del objeto de excepción y también usa el Message propiedad para mostrar el texto del mensaje de excepción.

using System;

public class Example 
{
    static void Main() 
    {
        // Define some integers for a division operation.
        int[] values = { 10, 7 };
        foreach (var value in values) {
            try {
               Console.WriteLine("{0} divided by 2 is {1}", value, DivideByTwo(value));
            }
            catch (ArgumentException e) {
               Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message);
            }
            Console.WriteLine();
        }
    }

    static int DivideByTwo(int num) 
    {
        // If num is an odd number, throw an ArgumentException.
        if ((num & 1) == 1)
            throw new ArgumentException(String.Format("{0} is not an even number", num), 
                                      "num");

        // num is even, return half of its value.
        return num / 2;
    }
}
// This example displays the following output:
//     10 divided by 2 is 5
//     
//     ArgumentException: 7 is not an even number
//     Parameter name: num

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: