ArgumentException Classe

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

ArgumentException.cs

A exceção que é gerada quando um dos argumentos fornecidos para um método não é válido.

C#

public class ArgumentException : SystemException

Herança

Object

Exception

SystemException

ArgumentException

Derivado

System.ArgumentNullException

System.ArgumentOutOfRangeException

System.ComponentModel.InvalidAsynchronousStateException

System.ComponentModel.InvalidEnumArgumentException

System.DuplicateWaitObjectException

System.Globalization.CultureNotFoundException

System.IO.Log.ReservationNotFoundException

System.Text.DecoderFallbackException

System.Text.EncoderFallbackException

System.Text.RegularExpressions.RegexParseException

Exemplos

O exemplo a seguir demonstra como lançar e capturar um ArgumentException. Ele usa ArgumentException.GetType(). Propriedade Name para exibir o nome do objeto de exceção e também usa a Message propriedade para exibir o texto da mensagem de exceção.

C#

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

Comentários

ArgumentException é gerado quando um método é invocado e pelo menos um dos argumentos passados não atende à especificação de parâmetro do método chamado. A ParamName propriedade identifica o argumento inválido.

Mais comumente, um ArgumentException é gerado pelo Common Language Runtime ou outra biblioteca de classes e indica o erro do desenvolvedor. Se você lançar um ArgumentException do código, deverá garantir que a propriedade da Message exceção inclua uma mensagem de erro significativa que descreva o argumento inválido e o intervalo esperado de valores para o argumento.

As classes derivadas primárias de ArgumentException são ArgumentNullException e ArgumentOutOfRangeException. Essas classes derivadas devem ser usadas em vez de ArgumentException, exceto em situações em que nenhuma das classes derivadas é aceitável. Por exemplo, as exceções devem ser geradas por:

• ArgumentNullException sempre que null é passado para um método que não o aceita como um argumento válido.

• ArgumentOutOfRangeException quando o valor de um argumento está fora do intervalo de valores aceitáveis; por exemplo, quando o valor "46" é passado como o argumento de mês durante a criação de um DateTime.

Se a chamada de método não tiver nenhum argumento ou se a falha não envolver os argumentos em si, deverá InvalidOperationException ser usada.

ArgumentException usa o COR_E_ARGUMENT HRESULT, que tem o valor 0x80070057.

Para obter uma lista de valores de propriedade inicial para uma instância do ArgumentException, consulte o ArgumentException construtores.

Em F#, você pode usar a função invalidArg para gerar e gerar um ArgumentException.

Construtores

ArgumentException()	Inicializa uma nova instância da classe ArgumentException.
ArgumentException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe ArgumentException com dados serializados.
ArgumentException(String)	Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada.
ArgumentException(String, Exception)	Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.
ArgumentException(String, String)	Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada e o nome do parâmetro que causa essa exceção.
ArgumentException(String, String, Exception)	Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada, o nome do parâmetro e uma referência à exceção interna que é a causa dessa exceção.

Propriedades

Data	Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção. (Herdado de Exception)
HelpLink	Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception)
HResult	Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a instância Exception que causou a exceção atual. (Herdado de Exception)
Message	Obtém a mensagem de erro e o nome do parâmetro ou apenas a mensagem de erro se não houver nenhum nome de parâmetro definido.
ParamName	Obtém o nome do parâmetro que causa essa exceção.
Source	Obtém ou define o nome do aplicativo ou objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gerou a exceção atual. (Herdado de Exception)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBaseException()	Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Define o objeto SerializationInfo com o nome do parâmetro e informações adicionais de exceção.
GetType()	Obtém o tipo de runtime da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ThrowIfNullOrEmpty(String, String)	Gera uma exceção se argument estiver null ou estiver vazia.
ThrowIfNullOrWhiteSpace(String, String)	Gera uma exceção se argument for null, vazio ou consistir apenas em caracteres de espaço em branco.
ToString()	Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception)

Eventos

SerializeObjectState

Obsoleto. Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception)

Aplica-se a

Confira também

• Exception
• Manipulando e lançando exceções