Classe Platform::Exception
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 Exception classe herda os Equals()métodos , Finalize(), GetHashCode(), GetType(), MemberwiseClose(), e ToString() da classe Platform::Object. 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 retorno
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).