Platform::Exception Class

Az alkalmazás végrehajtása során előforduló hibákat jelöli. Az egyéni kivételosztályok nem származtathatók Platform::Exception. Ha egyéni kivételre van szüksége, használhatja a Platform::COMException, és megadhat egy alkalmazásspecifikus HRESULT-t.

Szintaxis

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

Tagok

A Exception osztály örökli a Object osztályt, valamint a IException, IPrintableés IEquatable interfészeket.

A Exception osztály a következő típusú tagokat is tartalmazza.

Konstruktorok

Tag	Leírás
kivétel::Kivétel	Inicializálja a Exception osztály új példányát.

Módszerek

A Exception osztály a Equals()Finalize(), GetHashCode(), GetType(), MemberwiseClose(), ToString()és metódusokat örökli. A Exception osztály a következő metódust is tartalmazza.

Tag	Leírás
Kivétel::CreateException	Létrehoz egy kivételt, amely a megadott HRESULT értéket jelöli.

Kellékek

A Kivétel osztály az alábbi tulajdonságokkal is rendelkezik.

Tag	Leírás
kivétel::HResult	A kivételnek megfelelő HRESULT.
kivétel::Üzenet	A kivételt leíró üzenet. Ez az érték írásvédett, és nem módosítható a Exception létrehozása után.

Követelmények

Minimálisan támogatott ügyfél: Windows 8

Minimálisan támogatott kiszolgáló: Windows Server 2012

névtér: platform

metaadatok: platform.winmd

Kivétel::CreateException metódus

Létrehoz egy platform::Exception^ értéket egy megadott HRESULT-értékből.

Szintaxis

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

Paraméterek

hr
Egy HRESULT-érték, amelyet általában egy COM-metódus hívásából kap. Ha az érték 0, amely egyenlő S_OK, ez a módszer Platform::InvalidArgumentException, mert a sikeres COM-metódusok nem szabad kivételeket dobni.

üzenet
A hibát leíró sztring.

Visszaadott érték

Kivétel, amely a HRESULT hibát jelöli.

Megjegyzések

Ezzel a metódussal kivételt hozhat létre egy HRESULT-ból, amelyet a rendszer például egy COM-felületi metódusra irányuló hívásból ad vissza. Az egyéni üzenet megadásához használhatja a String^ paramétert használó túlterhelést.

Erősen ajánlott a CreateException használatával erős típusú kivételt létrehozni ahelyett, hogy létrehoz egy platformot::COMException, amely csak a HRESULT-ot tartalmazza.

Kivétel::Kivételkonstruktor

Inicializálja a Kivétel osztály új példányát.

Szintaxis

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

Paraméterek

hresult
A kivétel által képviselt HRESULT hiba.

üzenet
A kivételhez társított, felhasználó által megadott üzenet, például az előíró szöveg. Általában a második túlterhelést kell előnyben részesítenie, hogy a lehető legkiválóbb leíró üzenetet jelenítsen meg a hiba előfordulásának módjáról és okáról.

Kivétel::HResult tulajdonság

A kivételnek megfelelő HRESULT.

Szintaxis

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

Tulajdonság értéke

HRESULT érték.

Megjegyzések

A legtöbb kivétel COM-hibákból indul ki, amelyeket HRESULT-értékekként adnak vissza. A C++/CX platform::Exception^ objektumokká alakítja ezeket az értékeket, és ez a tulajdonság az eredeti hibakód értékét tárolja.

Kivétel::Üzenet tulajdonság

A hibát leíró üzenet.

Szintaxis

public:
    property String^ Message;

Tulajdonság értéke

A Windows futtatókörnyezetből származó kivételek esetén ez a hiba rendszer által megadott leírása.

Megjegyzések

A Windows 8 rendszerben ez a tulajdonság írásvédett, mert a Windows futtatókörnyezet ezen verziójának kivételei csak HRESULTS-ként lesznek átszállítva az ABI-n. A Windows 8.1-ben a rendszer gazdagabb kivételadatokat küld az ABI-n keresztül, és megadhat egy egyéni üzenetet, amelyet más összetevők programozott módon érhetnek el. További információ: Kivételek (C++/CX).

Lásd még:

platformnévtér