ArgumentException Construtores

Definição

Espaço de Nomes:: System

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da ArgumentException classe.

Sobrecargas

Name	Description
ArgumentException()	Inicializa uma nova instância da ArgumentException classe.
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

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Inicializa uma nova instância da ArgumentException classe.

public:
 ArgumentException();

public ArgumentException();

Public Sub New ()

Observações

Este construtor inicializa a Message propriedade da nova instância numa mensagem fornecida pelo sistema que descreve o erro, como "Foi especificado um argumento inválido." Esta mensagem tem em conta a cultura atual do sistema.

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de ArgumentException.

Property	Value
InnerException	Uma referência nula (`Nothing` em Visual Basic).
Message	A cadeia de mensagens de erro localizadas.

Aplica-se a

ArgumentException(String)

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

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

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.

Observações

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de ArgumentException.

Property	Value
InnerException	Uma referência nula (`Nothing` em Visual Basic).
Message	A cadeia de mensagens de erro.

Aplica-se a

ArgumentException(SerializationInfo, StreamingContext)

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Atenção

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

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

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

A informação contextual sobre a origem ou destino.

Atributos: ObsoleteAttribute

Observações

Este construtor é chamado durante a desserialização para reconstituir o objeto exceção transmitido através de um fluxo. Para mais informações, consulte XML e Serialização SOAP.

Ver também

Serialização XML e SOAP

Aplica-se a

ArgumentException(String, Exception)

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

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

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 innerException parâmetro não for uma referência nula, a exceção atual é elevada num catch bloco que trata a exceção interna.

Observações

Este 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 pelos humanos. O chamador deste construtor é obrigado a garantir que esta cadeia foi localizada para a cultura do sistema atual.

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

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de ArgumentException.

Property	Value
InnerException	A referência à exceção interna.
Message	A cadeia de mensagens de erro localizadas.

Ver também

Aplica-se a

ArgumentException(String, String)

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

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

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 seguinte exemplo de código 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;

Observações

Este construtor inicializa a ParamName propriedade da nova instância usando paramName. O conteúdo de paramName destina-se a ser compreendido pelos humanos.

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de ArgumentException.

Property	Value
Message	A cadeia de mensagens de erro.
ParamName	O nome do parâmetro string.

Aplica-se a

ArgumentException(String, String, Exception)

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

Origem:: ArgumentException.cs

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

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 innerException parâmetro não for uma referência nula, a exceção atual é elevada num catch bloco que trata a exceção interna.

Observações

Este construtor inicializa a ParamName propriedade da nova instância usando paramName. O conteúdo de paramName destina-se a ser compreendido pelos humanos.

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de ArgumentException.

Property	Value
InnerException	A referência à exceção interna.
Message	A cadeia de mensagens de erro localizadas.
ParamName	O nome do parâmetro string.

Ver também

Aplica-se a

Comentários

Esta página foi útil?