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::Exception
tü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
, IPrintable
ve 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).