ArgumentException Construtores

Definição

Inicializa uma nova instância da classe ArgumentException.

Sobrecargas

ArgumentException()

Inicializa uma nova instância da classe ArgumentException.

ArgumentException(String)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada.

ArgumentException(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da classe ArgumentException com dados serializados.

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.

ArgumentException()

Inicializa uma nova instância da classe ArgumentException.

public:
 ArgumentException();
public ArgumentException ();
Public Sub New ()

Comentários

Esse construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "Um argumento inválido foi especificado". Essa mensagem leva em conta a cultura atual do sistema.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de ArgumentException.

Propriedade Valor
InnerException Uma referência nula (Nothing no Visual Basic).
Message A cadeia de caracteres da mensagem de erro localizada.

Aplica-se a

ArgumentException(String)

Inicializa uma nova instância da classe ArgumentException com uma mensagem de erro especificada.

public:
 ArgumentException(System::String ^ message);
public ArgumentException (string message);
public ArgumentException (string? message);
new ArgumentException : string -> ArgumentException
Public Sub New (message As String)

Parâmetros

message
String

A mensagem de erro que explica a razão da exceção.

Comentários

Esse construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "Um argumento inválido foi especificado". Essa mensagem leva em conta a cultura atual do sistema.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de ArgumentException.

Propriedade Valor
InnerException Uma referência nula (Nothing no Visual Basic).
Message A cadeia de caracteres da mensagem de erro.

Aplica-se a

ArgumentException(SerializationInfo, StreamingContext)

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da classe ArgumentException com dados serializados.

protected:
 ArgumentException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ArgumentException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected ArgumentException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info
SerializationInfo

O objeto que mantém os dados de objeto serializados.

context
StreamingContext

As informações contextuais sobre a origem ou o destino.

Atributos

Comentários

O construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido em um fluxo. Para obter mais informações, consulte serialização XML e SOAP.

Confira também

Aplica-se a

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.

public:
 ArgumentException(System::String ^ message, Exception ^ innerException);
public ArgumentException (string message, Exception innerException);
public ArgumentException (string? message, Exception? innerException);
new ArgumentException : string * Exception -> ArgumentException
Public Sub New (message As String, innerException As Exception)

Parâmetros

message
String

A mensagem de erro que explica a razão da exceção.

innerException
Exception

A exceção que é a causa da exceção atual. Se o parâmetro innerException não for uma referência nula, a exceção atual será gerada em um bloco catch que lida com a exceção interna.

Comentários

Esse construtor inicializa a Message propriedade da nova instância usando o valor do message parâmetro . O conteúdo do parâmetro message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

Uma exceção que é lançada como um resultado direto de uma exceção anterior deve incluir uma referência para a exceção anterior na propriedade InnerException. A propriedade InnerException retorna o mesmo valor passado ao construtor, ou null se a propriedade InnerException não fornecer o valor da exceção interna ao construtor.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de ArgumentException.

Propriedade Valor
InnerException A referência de exceção interna.
Message A cadeia de caracteres da mensagem de erro localizada.

Confira também

Aplica-se a

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.

public:
 ArgumentException(System::String ^ message, System::String ^ paramName);
public ArgumentException (string message, string paramName);
public ArgumentException (string? message, string? paramName);
new ArgumentException : string * string -> ArgumentException
Public Sub New (message As String, paramName As String)

Parâmetros

message
String

A mensagem de erro que explica a razão da exceção.

paramName
String

O nome do parâmetro que causou a exceção atual.

Exemplos

O exemplo de código a seguir demonstra como chamar o ArgumentException construtor. Este exemplo de código faz parte de um exemplo maior fornecido para a ArgumentException classe .

int DivideByTwo(int num)
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
    {
        throw gcnew ArgumentException("Number must be even", "num");
    }
    // num is even, return half of its value.
    return num / 2;
}
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;
}
let divideByTwo num =
    // If num is an odd number, raise an ArgumentException.
    if num % 2 = 1 then
        raise (ArgumentException("num", "Number must be even"))

    // num is even, return half of its value.
    num / 2;

Comentários

Esse construtor inicializa a Message propriedade da nova instância usando o valor do message parâmetro . O conteúdo do parâmetro message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

Esse construtor inicializa a ParamName propriedade da nova instância usando paramName. O conteúdo de paramName deve ser compreendido por humanos.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de ArgumentException.

Propriedade Valor
Message A cadeia de caracteres da mensagem de erro.
ParamName A cadeia de caracteres do nome do parâmetro.

Aplica-se a

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.

public:
 ArgumentException(System::String ^ message, System::String ^ paramName, Exception ^ innerException);
public ArgumentException (string message, string paramName, Exception innerException);
public ArgumentException (string? message, string? paramName, Exception? innerException);
new ArgumentException : string * string * Exception -> ArgumentException
Public Sub New (message As String, paramName As String, innerException As Exception)

Parâmetros

message
String

A mensagem de erro que explica a razão da exceção.

paramName
String

O nome do parâmetro que causou a exceção atual.

innerException
Exception

A exceção que é a causa da exceção atual. Se o parâmetro innerException não for uma referência nula, a exceção atual será gerada em um bloco catch que lida com a exceção interna.

Comentários

Esse construtor inicializa a Message propriedade da nova instância usando o valor do message parâmetro . O conteúdo do parâmetro message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

Esse construtor inicializa a ParamName propriedade da nova instância usando paramName. O conteúdo de paramName deve ser compreendido por humanos.

Uma exceção que é lançada como um resultado direto de uma exceção anterior deve incluir uma referência para a exceção anterior na propriedade InnerException. A propriedade InnerException retorna o mesmo valor passado ao construtor, ou null se a propriedade InnerException não fornecer o valor da exceção interna ao construtor.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de ArgumentException.

Propriedade Valor
InnerException A referência de exceção interna.
Message A cadeia de caracteres da mensagem de erro localizada.
ParamName A cadeia de caracteres do nome do parâmetro.

Confira também

Aplica-se a