Platform::Exception, klasa

Reprezentuje błędy występujące podczas wykonywania aplikacji. Niestandardowe klasy wyjątków nie mogą pochodzić z klasy Platform::Exception. Jeśli potrzebujesz wyjątku niestandardowego, możesz użyć Platform::COMException i określić wartość HRESULT specyficzną dla aplikacji.

Składnia

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

Elementy członkowskie

Klasa Exception dziedziczy z Object klasy i IExceptioninterfejsów , IPrintablei IEquatable .

Klasa Exception ma również następujące rodzaje składowych.

Konstruktory

Element członkowski	opis
Exception::Exception	Inicjuje nowe wystąpienie klasy Exception.

Metody

Klasa Exception dziedziczy Equals()metody , , Finalize()GetHashCode()GetType(), MemberwiseClose(), i ToString() z klasy Platform::Object. Klasa Exception ma również następującą metodę.

Element członkowski	opis
Exception::CreateException	Tworzy wyjątek reprezentujący określoną wartość HRESULT.

Właściwości

Klasa Exception ma również następujące właściwości.

Element członkowski	opis
Exception::HResult	HRESULT, który odpowiada wyjątkowi.
Exception::Message	Komunikat, który opisuje wyjątek. Ta wartość jest tylko do odczytu i nie można jej modyfikować po utworzeniu Exception .

Wymagania

Minimalny obsługiwany klient: Windows 8

Minimalny obsługiwany serwer: Windows Server 2012

Przestrzeń nazw: Platforma

Metadane: platform.winmd

Exception::CreateException, metoda

Tworzy wartość Platform::Exception^ z określonej wartości HRESULT.

Składnia

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

Parametry

Hr
Wartość HRESULT, która zwykle jest pobierana z wywołania metody COM. Jeśli wartość to 0, która jest równa S_OK, ta metoda zgłasza wyjątek Platform::InvalidArgumentException , ponieważ metody COM, które kończą się powodzeniem, nie powinny zgłaszać wyjątków.

message
Ciąg opisujący błąd.

Wartość zwracana

Wyjątek reprezentujący błąd HRESULT.

Uwagi

Użyj tej metody, aby utworzyć wyjątek z hrESULT zwrócony, na przykład z wywołania metody interfejsu COM. Aby podać niestandardowy komunikat, możesz użyć przeciążenia, które przyjmuje parametr String^.

Zdecydowanie zaleca się użycie wyjątku CreateException w celu utworzenia silnie typizowanego wyjątku zamiast tworzenia wyjątku Platform::COMException , który zawiera tylko hrESULT.

Exception::Exception, konstruktor

Inicjuje nowe wystąpienie klasy Exception.

Składnia

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

Parametry

hresult
Błąd HRESULT reprezentowany przez wyjątek.

message
Komunikat określony przez użytkownika, taki jak tekst preskrypcyjny, który jest skojarzony z wyjątkiem. Ogólnie rzecz biorąc, należy preferować drugie przeciążenie, aby podać opisowy komunikat, który jest tak szczegółowy, jak to możliwe, o tym, jak i dlaczego wystąpił błąd.

Exception::HResult, właściwość

HRESULT, który odpowiada wyjątkowi.

Składnia

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

Wartość właściwości

Wartość HRESULT.

Uwagi

Większość wyjątków zaczyna się od błędów COM, które są zwracane jako wartości HRESULT. Język C++/CX konwertuje te wartości na obiekty Platform::Exception^, a ta właściwość przechowuje wartość oryginalnego kodu błędu.

Exception::Message, właściwość

Komunikat opisujący błąd.

Składnia

public:
    property String^ Message;

Wartość właściwości

W wyjątkach, które pochodzą z środowisko wykonawcze systemu Windows, jest to podany przez system opis błędu.

Uwagi

W systemie Windows 8 ta właściwość jest tylko do odczytu, ponieważ wyjątki w tej wersji środowisko wykonawcze systemu Windows są transportowane tylko w usłudze ABI jako HRESULTS. W systemie Windows 8.1 bogatsze informacje o wyjątkach są transportowane w usłudze ABI i można podać niestandardowy komunikat, do którego inne składniki mogą uzyskiwać dostęp programowo. Aby uzyskać więcej informacji, zobacz Wyjątki (C++/CX).

Zobacz też

Przestrzeń nazw platformy