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
Członkowie
Klasa Exception
dziedziczy z Object
klasy i IException
interfejsów , IPrintable
i 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()
MemberwiseClose()
GetType()
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
Intializuje 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ż
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla