Aracılığıyla paylaş


Platform::Exception Sınıfı

Uygulama yürütme sırasında oluşan hataları temsil eder. Özel özel durum sınıfları'ndan Platform::Exceptiontüretilemiyor. Özel bir özel durum gerekiyorsa, uygulamaya özgü bir HRESULT kullanabilir Platform::COMException ve belirtebilirsiniz.

Sözdizimi

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

Üyeler

sınıfı Exception , sınıfından Object ve IException, IPrintableve IEquatable arabirimlerinden devralır.

Sınıfı ayrıca Exception aşağıdaki üye türlerine sahiptir.

Oluşturucular

Üye Açıklama
Özel Durum::Özel Durum Exception sınıfının yeni bir örneğini başlatır.

Yöntemler

Exception sınıfı, Platform::Object Sınıfından , Finalize()GetHashCode(), GetType()MemberwiseClose()ve ToString() yöntemlerini devralır.Equals() sınıfı Exception da aşağıdaki yönteme sahiptir.

Üye Açıklama
Özel Durum::CreateException Belirtilen HRESULT değerini temsil eden bir özel durum oluşturur.

Properties

Exception sınıfı da aşağıdaki özelliklere sahiptir.

Üye Açıklama
Özel Durum::HResult Özel duruma karşılık gelen HRESULT.
Özel Durum::İleti Özel durumu açıklayan bir ileti. Bu değer salt okunurdur ve oluşturulurken değiştirilemez Exception .

Gereksinimler

Desteklenen en düşük istemci: Windows 8

Desteklenen en düşük sunucu: Windows Server 2012

Ad Alanı: Platform

Meta veriler: platform.winmd

Exception::CreateException Yöntemi

Belirtilen HRESULT değerinden Platform::Exception^ oluşturur.

Sözdizimi

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

Parametreler

Hr
Genellikle COM yöntemine yapılan bir çağrıdan elde ettiğiniz HRESULT değeri. Değer S_OK eşit olan 0 ise, başarılı COM yöntemleri özel durumlar oluşturmaması gerektiğinden bu yöntem Platform::InvalidArgumentException oluşturur.

ileti
Hatayı açıklayan bir dize.

Dönüş Değeri

HRESULT hatasını temsil eden bir özel durum.

Açıklamalar

Döndürülen hresult dışında bir özel durum oluşturmak için bu yöntemi kullanın, örneğin, bir COM arabirimi yöntemi çağrısından. Özel bir ileti sağlamak için String^ parametresini alan aşırı yüklemeyi kullanabilirsiniz.

Yalnızca HRESULT içeren bir Platform::COMException oluşturmak yerine kesin olarak belirlenmiş bir özel durum oluşturmak için CreateException kullanılması kesinlikle önerilir.

Özel Durum::Özel Durum Oluşturucu

Exception sınıfının yeni bir örneğini başlatır.

Sözdizimi

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

Parametreler

hresult
Özel durum tarafından temsil edilen HRESULT hatası.

ileti
Özel durumla ilişkili, açıklayıcı metin gibi kullanıcı tarafından belirtilen bir ileti. Genel olarak, hatanın nasıl ve neden oluştuğu hakkında mümkün olduğunca açıklayıcı bir ileti sağlamak için ikinci aşırı yüklemeyi tercih etmelisiniz.

Özel Durum::HResult Özelliği

Özel duruma karşılık gelen HRESULT.

Sözdizimi

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

Özellik Değeri

HRESULT değeri.

Açıklamalar

Çoğu özel durum, HRESULT değerleri olarak döndürülen COM hataları olarak başlar. C++/CX bu değerleri Platform::Exception^ nesnelerine dönüştürür ve bu özellik özgün hata kodunun değerini depolar.

Özel Durum::İleti Özelliği

Hatayı açıklayan ileti.

Sözdizimi

public:property String^ Message;

Özellik Değeri

Windows Çalışma Zamanı kaynaklı özel durumlarda, bu hatanın sistem tarafından sağlanan bir açıklamasıdır.

Açıklamalar

Windows 8'de, Windows Çalışma Zamanı sürümündeki özel durumlar YALNıZCA HRESULTS olarak ABI üzerinden taşındığından bu özellik salt okunurdur. Windows 8.1, ABI genelinde daha zengin özel durum bilgileri taşınır ve diğer bileşenlerin program aracılığıyla erişebileceği özel bir ileti sağlayabilirsiniz. Daha fazla bilgi için bkz . Özel Durumlar (C++/CX).

Ayrıca bkz.

Platform ad alanı