ExceptionRoutedEventArgs Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan data peristiwa untuk pengecualian yang dimunculkan sebagai peristiwa oleh operasi asinkron, seperti ImageFailed.
public ref class ExceptionRoutedEventArgs : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ExceptionRoutedEventArgs : RoutedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ExceptionRoutedEventArgs : RoutedEventArgs
Public Class ExceptionRoutedEventArgs
Inherits RoutedEventArgs
- Warisan
- Turunan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Contoh ini menunjukkan penggunaan ExceptionRoutedEventArgs dalam handler untuk mendapatkan HResult dan pesan kesalahan.
private void videoMediaElement_MediaFailed(object sender, ExceptionRoutedEventArgs e)
{
// get HRESULT from event args
string hr = GetHresultFromErrorMessage(e);
// Handle media failed event appropriately
}
private string GetHresultFromErrorMessage(ExceptionRoutedEventArgs e)
{
String hr = String.Empty;
String token = "HRESULT - ";
const int hrLength = 10; // eg "0xFFFFFFFF"
int tokenPos = e.ErrorMessage.IndexOf(token, StringComparison.Ordinal);
if (tokenPos != -1)
{
hr = e.ErrorMessage.Substring(tokenPos + token.Length, hrLength);
}
return hr;
}
Keterangan
Jangan tampilkan string ErrorMessage kepada pengguna akhir. Sebagai gantinya, gunakan substring dan kode dalam string untuk mengidentifikasi kondisi kesalahan secara positif, dan minta aplikasi Anda mengambil tindakan yang sesuai atau menampilkan informasi yang sesuai pengguna di UI aplikasi.
ExceptionRoutedEventArgs adalah data peristiwa untuk beberapa peristiwa yang menggunakan delegasi ExceptionRoutedEventHandler . Ini termasuk:
- Image.ImageFailed
- ImageBrush.ImageFailed
- BitmapImage.ImageFailed
- MediaElement.MediaFailed; untuk kejadian ini Anda dapat mentransmisikan data peristiwa ke hasil MediaFailedRoutedEventArgs yang lebih spesifik.
Kelas turunan ExceptionRoutedEventArgs
ExceptionRoutedEventArgs adalah kelas induk untuk MediaFailedRoutedEventArgs.
Properti
ErrorMessage |
Mendapatkan komponen pesan pengecualian, sebagai string. |
OriginalSource |
Mendapatkan referensi ke objek yang memunculkan peristiwa. Ini sering merupakan bagian templat dari kontrol daripada elemen yang dideklarasikan di UI aplikasi Anda. (Diperoleh dari RoutedEventArgs) |