Platform::Exception (classe)

  • Article

Représente les erreurs qui se produisent pendant l'exécution de l'application. Les classes d'exception personnalisées ne peuvent pas être dérivées d' Platform::Exception. Si vous avez besoin d'une exception personnalisée, vous pouvez utiliser Platform::COMException et spécifier un HRESULT propre à l'application.

Syntaxe

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

Membres

La classe Exception hérite de la classe Object et des interfaces IException, IPrintableet IEquatable .

La classe Exception comporte également les types de membres ci-dessous.

Constructeurs

Membre Description
Exception ::Exception Initialise une nouvelle instance de la classe Exception.

Méthodes

La classe Exception hérite des méthodes Equals(), Finalize(),GetHashCode(),GetType(),MemberwiseClose()et ToString() de la Platform::Object Class. La classe Exception comporte aussi la méthode ci-dessous.

Membre Description
Exception ::CreateException Crée une exception qui représente la valeur HRESULT spécifiée.

Propriétés

La classe Exception comporte aussi les propriétés ci-dessous.

Membre Description
Exception ::HResult HRESULT qui correspond à l'exception.
Exception ::Message Message qui décrit l'exception. Cette valeur est en lecture seule et ne peut pas être modifiée après la construction d' Exception .

Spécifications

Client minimum pris en charge : Windows 8

Serveur minimum pris en charge : Windows Server 2012

Espace de noms : Platform

Métadonnées : platform.winmd

Exception::CreateException, méthode

Crée Platform::Exception^ à partir d'une valeur HRESULT spécifique.

Syntaxe

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

Paramètres

Hr
Valeur HRESULT que vous obtenez généralement à partir d'un appel à une méthode COM. Si la valeur est 0, qui est égale à S_OK, cette méthode lève Platform ::InvalidArgumentException , car les méthodes COM qui réussissent ne doivent pas lever d’exceptions.

message
Chaîne qui décrit l'erreur.

Valeur de retour

Exception qui représente l'erreur HRESULT.

Notes

Utilisez cette méthode pour créer une exception à partir d'une valeur HRESULT retournée, par exemple, à partir d'un appel à une méthode d'interface COM. Utilisez la surcharge qui accepte un paramètre String^ pour fournir un message personnalisé.

Il est fortement recommandé d’utiliser CreateException pour créer une exception fortement typée plutôt que de créer une exception Platform ::COMException qui contient simplement HRESULT.

Exception::Exception, constructeur

Initialise une nouvelle instance de la classe Exception.

Syntaxe

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

Paramètres

Hresult
Erreur HRESULT qui est représentée par l'exception.

message
Message spécifié par l'utilisateur, tel que le texte normatif, qui est associé à l'exception. En général, préférez la deuxième surcharge afin de fournir un message descriptif aussi précis que possible en indiquant comment et pourquoi l'erreur s'est produite.

Exception::HResult, propriété

HRESULT qui correspond à l'exception.

Syntaxe

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

Valeur de propriété

Valeur HRESULT.

Notes

La plupart des exceptions démarrent sous forme d'erreurs COM, qui sont retournées en tant que valeurs HRESULT. C++/CX convertit ces valeurs en objets Platform::Exception^, et cette propriété stocke la valeur du code d'erreur d'origine.

Exception::Message, propriété

Message qui décrit l'erreur.

Syntaxe

public:property String^ Message;

Valeur de propriété

Dans les exceptions qui proviennent de Windows Runtime, il s'agit d'une description de l'erreur fournie par le système.

Notes

Dans Windows 8, cette propriété est en lecture seule, car les exceptions de cette version de Windows Runtime sont transportées dans l’ABI uniquement en tant que HRESULTS. Dans Windows 8.1, les informations sur l'exception traversent ABI. Par ailleurs, vous pouvez fournir un message personnalisé accessible par programmation à d'autres composants. Pour plus d’informations, consultez Exceptions (C++/CX).

Voir aussi

Espace de noms de plateforme