ApplicationException Construtores

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Inicializa uma nova instância da classe ApplicationException.

Sobrecargas

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

ApplicationException()

Origem:

ApplicationException.cs

Inicializa uma nova instância da classe ApplicationException.

public:
 ApplicationException();

public ApplicationException ();

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 "Ocorreu um erro de aplicativo". 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 ApplicationException.

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

ApplicationException(String)

Origem:

ApplicationException.cs

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

public:
 ApplicationException(System::String ^ message);

public ApplicationException (string? message);

new ApplicationException : string -> ApplicationException

Public Sub New (message As String)

Parâmetros

message

String

Uma mensagem que descreve o erro.

Comentários

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.

Essa mensagem considera a cultura do sistema atual.

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

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

ApplicationException(SerializationInfo, StreamingContext)

Origem:

ApplicationException.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 classe ApplicationException com dados serializados.

protected:
 ApplicationException(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 ApplicationException (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 ApplicationException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ApplicationException

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

ObsoleteAttribute

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

• Serialização XML e Soap

ApplicationException(String, Exception)

Origem:

ApplicationException.cs

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

public:
 ApplicationException(System::String ^ message, Exception ^ innerException);

public ApplicationException (string? message, Exception? innerException);

new ApplicationException : string * Exception -> ApplicationException

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

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. O InnerException propriedade retorna o mesmo valor que é passado para o construtor ou uma referência nula se o InnerException propriedade não fornece o valor de exceção interna para o construtor.

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

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

Confira também

• Exception
• Tratando e gerando exceções no .NET