ArgumentException (Clase)

ArgumentException se 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. Todas las instancias de ArgumentException deben incluir un mensaje de error descriptivo sobre el argumento que no es válido, así como el intervalo de valores esperado para ese argumento.

Las principales clases derivadas de ArgumentException son ArgumentNullException y ArgumentOutOfRangeException. Se deben utilizar estas clases derivadas en lugar de ArgumentException, excepto cuando ninguna de las clases derivadas sea aceptable. Por ejemplo, se deben producir excepciones en las siguientes circunstancias:

• ArgumentNullException, siempre que se pase referencia de objeto null (Nothing en Visual Basic) a un método que no la acepta como argumento válido.

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

Si la llamada al método no tiene ningún argumento o si el error no está relacionado con los argumentos en sí, se debe utilizar InvalidOperationException.

ArgumentException utiliza HRESULT COR_E_ARGUMENT, que tiene el valor 0x80070057.

Para obtener una lista con los valores de propiedad iniciales de una instancia de ArgumentException, vea los constructores ArgumentException.

En el siguiente ejemplo se muestra cómo producir y detectar ArgumentException.

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.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

.NET Compact Framework