Classe Platform::ExceptionPlatform::Exception Class

Representa erros que ocorrem durante a execução do aplicativo.Represents errors that occur during application execution. Classes de exceção personalizadas não podem ser derivadas de Platform::Exception.Custom exception classes can't be derived from Platform::Exception. Se você precisar de uma exceção personalizada, poderá usar Platform::COMException e especificar um HRESULT específico de aplicativo.If you require a custom exception, you can use Platform::COMException and specify an app-specific HRESULT.

SintaxeSyntax

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

MembrosMembers

A classe Exception herda da classe Object e das interfaces IException, IPrintablee IEquatable .The Exception class inherits from the Object class and the IException, IPrintable, and IEquatable interfaces.

A classe Exception também tem os tipos de membros a seguir.The Exception class also has the following kinds of members.

ConstrutoresConstructors

MembroMember DescriçãoDescription
Exception::ExceptionException::Exception Inicializa uma nova instância da classe Exception.Initializes a new instance of the Exception class.

MétodosMethods

A classe Exception herda os métodos Equals(), Finalize(),GetHashCode(),GetType(),MemberwiseClose()e ToString() da Platform::Object Class.The Exception class inherits the Equals(), Finalize(),GetHashCode(),GetType(),MemberwiseClose(), and ToString() methods from the Platform::Object Class. A classe Exception tem o método a seguir.The Exception class also has the following method.

MembroMember DescriçãoDescription
Exception::CreateExceptionException::CreateException Cria uma exceção que representa o valor HRESULT especificado.Creates an exception that represents the specified HRESULT value.

PropriedadesProperties

A classe Exception também tem as propriedades a seguir.The Exception class also has the following properties.

MembroMember DescriçãoDescription
Exception::HResultException::HResult O HRESULT que corresponde à exceção.The HRESULT that corresponds to the exception.
Exception::MessageException::Message Uma mensagem que descreve a exceção.A message that describes the exception. Esse valor é somente leitura e não pode ser modificado após a construção de Exception .This value is read-only and cannot be modified after the Exception is constructed.

RequisitosRequirements

Suporte mínimo de cliente: Windows 8Minimum supported client: Windows 8

Suporte mínimo de servidor: Windows Server 2012Minimum supported server: Windows Server 2012

Namespace: PlatformNamespace: Platform

Metadados: platform.winmdMetadata: platform.winmd

Método ExceptionException::CreateException Method

Cria uma Platform::Exception^ a partir de um valor HRESULT especificado.Creates a Platform::Exception^ from a specified HRESULT value.

SintaxeSyntax

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

ParâmetrosParameters

hrhr
Um valor HRESULT que você normalmente obtém de uma chamada para um método COM.An HRESULT value that you typically get from a call to a COM method. Se o valor for 0, que é igual a S_OK, esse método lançará Platform:: invalidargumentexception porque os métodos com bem-sucedidos não deverão gerar exceções.If the value is 0, which is equal to S_OK, this method throws Platform::InvalidArgumentException because COM methods that succeed should not throw exceptions.

mensagemmessage
Uma cadeia de caracteres que descreve o erro.A string that describes the error.

Valor de retornoReturn Value

Uma exceção que representa o HRESULT de erro.An exception that represents the error HRESULT.

ComentáriosRemarks

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.Use this method to create an exception out of an HRESULT that is returned, for example, from a call to a COM interface method. Você pode usar a sobrecarga que utiliza um parâmetro String^ para fornecer uma mensagem personalizada.You can use the overload that takes a String^ parameter to provide a custom message.

É altamente recomendável usar CreateException para criar uma exceção fortemente tipada em vez de criar um Platform:: COMException que simplesmente contenha o HRESULT.It is strongly recommended to use CreateException to create a strongly-typed exception rather than creating a Platform::COMException that merely contains the HRESULT.

Construtor Exception:: ExceptionException::Exception Constructor

Inicializa uma nova instância da classe Exception.Intializes a new instance of the Exception class.

SintaxeSyntax


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

ParâmetrosParameters

hresult
O erro HRESULT que é representado pela exceção.The error HRESULT that is represented by the exception.

message
Uma mensagem especificada pelo usuário, como texto prescritivo, que é associada à exceção.A user-specified message, such as prescriptive text, that is associated with the exception. 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.In general you should prefer the second overload in order to provide a descriptive message that is as specific as possible about how and why the error has occurred.

Propriedade Exception:: HRESULTException::HResult Property

O HRESULT que corresponde à exceção.The HRESULT that corresponds to the exception.

SintaxeSyntax

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

Valor de propriedadeProperty Value

Um valor HRESULT.An HRESULT value.

ComentáriosRemarks

A maioria das exceções começa como erros COM, que são retornados como valores HRESULT.Most exceptions start out as COM errors, which are returned as HRESULT values. C++/CX converte esses valores em objetos Platform::Exception^ e essa propriedade armazena o valor do código de erro original.C++/CX converts these values into Platform::Exception^ objects, and this property stores the value of the original error code.

Propriedade Exception:: MessageException::Message Property

Mensagem que descreve o erro.Message that describes the error.

SintaxeSyntax

public:property String^ Message;  

Valor de propriedadeProperty Value

Nas exceções originadas no Windows Runtime , essa é uma descrição do erro fornecida pelo sistema.In exceptions that originate in the Windows Runtime, this is a system-supplied description of the error.

ComentáriosRemarks

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.In Windows 8, this property is read-only because exceptions in that version of the Windows Runtime are transported across the ABI only as 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.In Windows 8.1, richer exception information is transported across the ABI and you can provide a custom message that other components can access programmatically. Para obter mais informações, consulte exceções (C + + CX).For more information, see Exceptions (C++/CX).

Consulte tambémSee Also

Namespace de plataformaPlatform namespace