Classe Platform::Exception

  • Artigo

Representa erros que ocorrem durante a execução do aplicativo. Classes de exceção personalizadas não podem ser derivadas de Platform::Exception. Se você precisar de uma exceção personalizada, poderá usar Platform::COMException e especificar um HRESULT específico de aplicativo.

Sintaxe

public ref class Exception : Object,    IException,    IPrintable,    IEquatable

Membros

A classe Exception herda da classe Object e das interfaces IException, IPrintablee IEquatable .

A classe Exception também tem os tipos de membros a seguir.

Construtores

Membro Descrição
Exception::Exception Inicializa uma nova instância da classe Exception.

Métodos

A classe Exception herda os métodos Equals(), Finalize(),GetHashCode(),GetType(),MemberwiseClose()e ToString() da Platform::Object Class. A classe Exception tem o método a seguir.

Membro Descrição
Exception::CreateException Cria uma exceção que representa o valor HRESULT especificado.

Propriedades

A classe Exception também tem as propriedades a seguir.

Membro Descrição
Exception::HResult O HRESULT que corresponde à exceção.
Exception::Message Uma mensagem que descreve a exceção. Esse valor é somente leitura e não pode ser modificado após a construção de Exception .

Requisitos

Cliente com suporte mínimo: Windows 8

Servidor com suporte mínimo: Windows Server 2012

Namespace: Platform

Metadados: platform.winmd

Método Exception::CreateException

Cria uma Platform::Exception^ a partir de um valor HRESULT especificado.

Sintaxe

Exception^ CreateException(int32 hr);
Exception^ CreateException(int32 hr, Platform::String^ message);

Parâmetros

RH
Um valor HRESULT que você normalmente obtém de uma chamada para um método COM. Se o valor for 0, que é igual a S_OK, esse método gerará Platform::InvalidArgumentException, pois os métodos COM bem-sucedidos não deverão gerar exceções.

message
Uma cadeia de caracteres que descreve o erro.

Valor de Devolução

Uma exceção que representa o HRESULT de erro.

Comentários

Use esse método para criar uma exceção fora de um HRESULT que é retornado, por exemplo, a partir de uma chamada para um método de interface COM. Você pode usar a sobrecarga que utiliza um parâmetro String^ para fornecer uma mensagem personalizada.

É altamente recomendável usar CreateException para criar uma exceção fortemente tipada em vez de criar uma Platform::COMException que simplesmente contenha o HRESULT.

Construtor Exception::Exception

Inicializa uma nova instância da classe Exception.

Sintaxe

Exception(int32 hresult);
Exception(int32 hresult, ::Platform::String^ message);

Parâmetros

hresult
O erro HRESULT que é representado pela exceção.

message
Uma mensagem especificada pelo usuário, como texto prescritivo, que é associada à exceção. Em geral, você deve preferir a segunda sobrecarga para fornecer uma mensagem descritiva que seja a mais específica possível sobre como e por que ocorreu o erro.

Propriedade Exception::HResult

O HRESULT que corresponde à exceção.

Sintaxe

public:
    property int HResult { int get(); }

Valor da propriedade

Um valor HRESULT.

Comentários

A maioria das exceções começa como erros COM, que são retornados como valores HRESULT. C++/CX converte esses valores em objetos Platform::Exception^ e essa propriedade armazena o valor do código de erro original.

Propriedade Exception::Message

Mensagem que descreve o erro.

Sintaxe

public:property String^ Message;

Valor da propriedade

Nas exceções originadas no Windows Runtime, essa é uma descrição do erro fornecida pelo sistema.

Comentários

No Windows 8, essa propriedade é somente leitura porque as exceções nessa versão do Windows Runtime são transportadas pela ABI somente como HRESULTS. No Windows 8.1, as informações de exceção mais detalhadas são transportadas pela ABI, e você pode fornecer uma mensagem personalizada que outros componentes podem acessar programaticamente. Para obter mais informações, confira Exceções (C++/CX).

Confira também

Namespace de plataforma