ExceptionRoutedEventArgs クラス

定義

名前空間:

Windows.UI.Xaml

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

継承

Object Platform::Object IInspectable RoutedEventArgs ExceptionRoutedEventArgs

派生

Windows.UI.Xaml.MediaFailedRoutedEventArgs

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

この例では、 HResult とエラー メッセージを取得するためにハンドラーで ExceptionRoutedEventArgs を使用する方法を示します。

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;
}

注釈

エンド ユーザーに ErrorMessage 文字列を表示しないでください。 代わりに、文字列内で部分文字列とコードを使用してエラー状態を肯定的に識別し、アプリで適切なアクションを実行するか、アプリ UI にユーザーに適した情報を表示します。

ExceptionRoutedEventArgs は、 ExceptionRoutedEventHandler デリゲートを使用するいくつかのイベントのイベント データです。 具体的な内容は次のとおりです。

• Image.ImageFailed
• ImageBrush.ImageFailed
• BitmapImage.ImageFailed
• MediaElement.MediaFailed;このイベントでは、イベント データをより具体的な MediaFailedRoutedEventArgs 結果に キャストできます。

ExceptionRoutedEventArgs 派生クラス

ExceptionRoutedEventArgs は MediaFailedRoutedEventArgs の親クラスです。

プロパティ

ErrorMessage	例外のメッセージ コンポーネントを文字列として取得します。
OriginalSource	イベントを発生させたオブジェクトへの参照を取得します。 これは多くの場合、アプリ UI で宣言された要素ではなく、コントロールのテンプレート部分です。 (継承元 RoutedEventArgs)

こちらもご覧ください

• RoutedEventArgs
• MediaFailed
• ImageFailed