Platform::Exception (Clase)Platform::Exception Class

Representa los errores que se producen durante la ejecución de la aplicación.Represents errors that occur during application execution. Las clases de excepción personalizadas no se pueden derivar de Platform::Exception.Custom exception classes can't be derived from Platform::Exception. Si necesitas una excepción personalizada, puedes utilizar Platform::COMException y especificar un HRESULT específico de la aplicación.If you require a custom exception, you can use Platform::COMException and specify an app-specific HRESULT.

SintaxisSyntax

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

MiembrosMembers

La clase Exception hereda de la clase Object y las interfaces IException, IPrintabley IEquatable .The Exception class inherits from the Object class and the IException, IPrintable, and IEquatable interfaces.

La clase Exception también tiene las siguientes clases de miembros.The Exception class also has the following kinds of members.

ConstructoresConstructors

MiembroMember DescripciónDescription
Exception:: ExceptionException::Exception Inicializa una nueva instancia de la clase Exception.Initializes a new instance of the Exception class.

MétodosMethods

La clase Exception hereda los métodos Equals(), Finalize(),GetHashCode(),GetType(),MemberwiseClose()y ToString() de Platform::Object Class.The Exception class inherits the Equals(), Finalize(),GetHashCode(),GetType(),MemberwiseClose(), and ToString() methods from the Platform::Object Class. La clase Exception también tiene el método siguiente.The Exception class also has the following method.

MiembroMember DescripciónDescription
Excepción:: CreateExceptionException::CreateException Crea una excepción que representa el valor HRESULT especificado.Creates an exception that represents the specified HRESULT value.

PropiedadesProperties

La clase Exception también tiene las propiedades siguientes.The Exception class also has the following properties.

MiembroMember DescripciónDescription
Excepción:: HResultException::HResult HRESULT correspondiente a la excepción.The HRESULT that corresponds to the exception.
Exception:: MessageException::Message Mensaje que describe la excepción.A message that describes the exception. Este valor es de solo lectura y se no puede modificarse después de que se haya generado Exception .This value is read-only and cannot be modified after the Exception is constructed.

RequisitosRequirements

Cliente mínimo admitido: Windows 8Minimum supported client: Windows 8

Servidor mínimo admitido: Windows Server 2012Minimum supported server: Windows Server 2012

Espacio de nombres: PlatformNamespace: Platform

Metadatos: Platform. winmdMetadata: platform.winmd

Exception:: CreateException (método)Exception::CreateException Method

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

SintaxisSyntax

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

ParámetrosParameters

hhr
Un valor HRESULT que se obtiene normalmente de una llamada a un método COM.An HRESULT value that you typically get from a call to a COM method. Si el valor es 0, que es igual a S_OK, este método produce una excepción Platform:: InvalidArgumentException porque los métodos com que se ejecutan correctamente no deben producir excepciones.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.

messagemessage
Cadena que describe el error.A string that describes the error.

Valor devueltoReturn Value

Una excepción que representa el HRESULT de error.An exception that represents the error HRESULT.

ComentariosRemarks

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.Use this method to create an exception out of an HRESULT that is returned, for example, from a call to a COM interface method. Puedes utilizar la sobrecarga que toma un parámetro String^ para proporcionar un mensaje personalizado.You can use the overload that takes a String^ parameter to provide a custom message.

Se recomienda encarecidamente usar CreateException para crear una excepción fuertemente tipada en lugar de crear una plataforma:: COMException que solo contenga el 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.

Exception:: Exception (constructor)Exception::Exception Constructor

Inicializa una nueva instancia de la clase Exception.Intializes a new instance of the Exception class.

SintaxisSyntax

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

ParámetrosParameters

valorhresult
Valor HRESULT de error representado por la excepción.The error HRESULT that is represented by the exception.

messagemessage
Mensaje especificado por el usuario, como texto preceptivo, asociado a la excepción.A user-specified message, such as prescriptive text, that is associated with the exception. 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.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.

Exception:: HResult (propiedad)Exception::HResult Property

HRESULT correspondiente a la excepción.The HRESULT that corresponds to the exception.

SyntaxSyntax

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

Valor de propiedadProperty Value

Valor HRESULT.An HRESULT value.

ComentariosRemarks

La mayoría de las excepciones comienzan como errores COM, que se devuelven como valores HRESULT.Most exceptions start out as COM errors, which are returned as HRESULT values. C++/CX convierte estos valores en objetos Platform::Exception^ y esta propiedad almacena el valor del código de error original.C++/CX converts these values into Platform::Exception^ objects, and this property stores the value of the original error code.

Exception:: Message (propiedad)Exception::Message Property

Mensaje que describe el error.Message that describes the error.

SyntaxSyntax

public:property String^ Message;

Valor de propiedadProperty Value

En las excepciones que se originan en Windows en tiempo de ejecución, es una descripción del error proporcionada por el sistema.In exceptions that originate in the Windows Runtime, this is a system-supplied description of the error.

ComentariosRemarks

En Windows 8, esta propiedad es de solo lectura porque las excepciones en esa versión del Windows Runtime se transportan a través de la ABI solo como valores HRESULT.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. 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.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 obtener más información, vea excepciones (C++/CX).For more information, see Exceptions (C++/CX).

Vea tambiénSee also

Espacio de nombres de plataformaPlatform namespace