Platform::Exception (Clase)

  • Artículo

Representa los errores que se producen durante la ejecución de la aplicación. Las clases de excepción personalizadas no se pueden derivar de Platform::Exception. Si necesitas una excepción personalizada, puedes utilizar Platform::COMException y especificar un HRESULT específico de la aplicación.

Sintaxis

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

Miembros

La clase Exception hereda de la clase Object y las interfaces IException, IPrintabley IEquatable .

La clase Exception también tiene las siguientes clases de miembros.

Constructores

Miembro Descripción
Exception::Exception Inicializa una nueva instancia de la clase Exception.

Métodos

La clase Exception hereda los métodos Equals(), Finalize(),GetHashCode(),GetType(),MemberwiseClose()y ToString() de Platform::Object Class. La clase Exception también tiene el método siguiente.

Miembro Descripción
Exception::CreateException Crea una excepción que representa el valor HRESULT especificado.

Propiedades

La clase Exception también tiene las propiedades siguientes.

Miembro Descripción
Exception::HResult HRESULT correspondiente a la excepción.
Exception::Message Mensaje que describe la excepción. Este valor es de solo lectura y se no puede modificarse después de que se haya generado Exception .

Requisitos

Cliente mínimo compatible: Windows 8

Servidor mínimo compatible: Windows Server 2012

Espacio de nombres: Plataforma

Metadatos: platform.winmd

Exception::CreateException (Método)

Crea una excepción Platform::Exception^ a partir de un valor HRESULT especificado.

Sintaxis

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

Parámetros

Hr
Un valor HRESULT que se obtiene normalmente de una llamada a un método COM. Si el valor es 0, que es igual a S_OK, este método produce una excepción Platform::InvalidArgumentException debido a que los métodos COM que se realizan correctamente no deben producir excepciones.

message
Cadena que describe el error.

Valor devuelto

Una excepción que representa el HRESULT de error.

Comentarios

Utiliza este método para crear una excepción a partir de un valor HRESULT devuelto, por ejemplo, desde una llamada a un método de interfaz COM. Puedes utilizar la sobrecarga que toma un parámetro String^ para proporcionar un mensaje personalizado.

Es muy recomendable utilizar CreateException para crear una excepción fuertemente tipada en lugar de crear una excepción Platform::COMException que simplemente contenga el valor HRESULT.

Exception::Exception (Constructor)

Inicializa una nueva instancia de la clase Exception.

Sintaxis

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

Parámetros

hresult
Valor HRESULT de error representado por la excepción.

message
Mensaje especificado por el usuario, como texto preceptivo, asociado a la excepción. Normalmente, deberías optar por la segunda sobrecarga para proporcionar un mensaje descriptivo que sea lo más específico posible sobre cómo y por qué se ha producido el error.

Exception::HResult (Propiedad)

HRESULT correspondiente a la excepción.

Sintaxis

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

Valor de propiedad

Valor HRESULT.

Comentarios

La mayoría de las excepciones comienzan como errores COM, que se devuelven como valores HRESULT. C++/CX convierte estos valores en objetos Platform::Exception^ y esta propiedad almacena el valor del código de error original.

Exception::Message (Propiedad)

Mensaje que describe el error.

Sintaxis

public:property String^ Message;

Valor de propiedad

En las excepciones que se originan en Windows en tiempo de ejecución, es una descripción del error proporcionada por el sistema.

Comentarios

En Windows 8, esta propiedad es de solo lectura debido a que las excepciones en esa versión de Windows Runtime se transmiten a través de la ABI solo como valores HRESULT. En Windows 8.1, se transmite información de excepción más completa a través de la ABI y puedes proporcionar un mensaje personalizado al que otros componentes podrán tener acceso mediante programación. Para obtener más información, consulte Excepciones (C++/CX).

Consulte también

Espacio de nombres de plataforma