ArgumentException Construtores

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Inicializa uma nova instância da classe ArgumentException.

Sobrecargas

Nome	Description
ArgumentException()	Inicializa uma nova instância da classe ArgumentException.
ArgumentException(String)	Inicializa uma nova instância da ArgumentException classe com uma mensagem de erro especificada.
ArgumentException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da ArgumentException classe com dados serializados.
ArgumentException(String, Exception)	Inicializa uma nova instância da ArgumentException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção.
ArgumentException(String, String)	Inicializa uma nova instância da ArgumentException classe 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 ArgumentException classe 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()

Origem:

ArgumentException.cs

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 iniciais de uma instância de ArgumentException.

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

ArgumentException(String)

Origem:

ArgumentException.cs

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

public:
 ArgumentException(System::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 o motivo 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 iniciais de uma instância de ArgumentException.

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

ArgumentException(SerializationInfo, StreamingContext)

Origem:

ArgumentException.cs

Cuidado

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

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

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);

[<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 contém os dados do objeto serializado.

context

StreamingContext

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

Atributos

ObsoleteAttribute

Comentários

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

Confira também

• Serialização XML e SOAP

ArgumentException(String, Exception)

Origem:

ArgumentException.cs

Inicializa uma nova instância da ArgumentException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção.

public:
 ArgumentException(System::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 o motivo da exceção.

innerException

Exception

A exceção que é a causa da exceção atual. Se o innerException parâmetro não for uma referência nula, a exceção atual será gerada em um catch bloco que manipula 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 message parâmetro destina-se a ser compreendido por humanos. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.

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

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

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

Confira também

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

ArgumentException(String, String)

Origem:

ArgumentException.cs

Inicializa uma nova instância da ArgumentException classe 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);

new ArgumentException : string * string -> ArgumentException

Public Sub New (message As String, paramName As String)

Parâmetros

message

String

A mensagem de erro que explica o motivo 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.

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 message parâmetro destina-se a ser compreendido por humanos. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.

Esse construtor inicializa a ParamName propriedade da nova instância usando paramName. O conteúdo é paramName destinado a ser compreendido pelos humanos.

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

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

ArgumentException(String, String, Exception)

Origem:

ArgumentException.cs

Inicializa uma nova instância da ArgumentException classe 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);

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 o motivo 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 innerException parâmetro não for uma referência nula, a exceção atual será gerada em um catch bloco que manipula 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 message parâmetro destina-se a ser compreendido por humanos. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.

Esse construtor inicializa a ParamName propriedade da nova instância usando paramName. O conteúdo é paramName destinado a ser compreendido pelos humanos.

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

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

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

Confira também

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