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 中引入)

示例

此示例演示如何在处理程序中使用 ExceptionRoutedEventArgs 来获取 HResult 和错误消息。

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