ExceptionRoutedEventArgs Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml

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.

Edit

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: Object Platform::Object IInspectable RoutedEventArgs ExceptionRoutedEventArgs

Turunan: Windows.UI.Xaml.MediaFailedRoutedEventArgs

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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)

Berlaku untuk