Platform::Exception (classe)
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 Exception classe hérite de la Equals()classe , , GetType()Finalize()GetHashCode(), MemberwiseClose()et ToString() des méthodes de la classe Platform ::Object. 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
rh
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).