Platform::Exception (Clase)
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 Exception clase hereda los Equals()métodos , 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).