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 для конечных пользователей. Вместо этого используйте подстроки и коды в строке, чтобы положительно определить условие ошибки и заставить приложение выполнить соответствующее действие или отобразить в пользовательском интерфейсе приложения соответствующие сведения.

ExceptionRoutedEventArgs — это данные событий для нескольких событий, использующих делегат ExceptionRoutedEventHandler . К ним относятся следующие объекты.

• Image.ImageFailed
• ImageBrush.ImageFailed
• BitmapImage.ImageFailed
• MediaElement.MediaFailed; для этого события можно привести данные события к более конкретному результату MediaFailedRoutedEventArgs .

Производные классы ExceptionRoutedEventArgs

ExceptionRoutedEventArgs — это родительский класс для MediaFailedRoutedEventArgs.

Свойства

ErrorMessage	Возвращает компонент сообщения исключения в виде строки.
OriginalSource	Возвращает ссылку на объект, вызвав которому событие. Часто это шаблонная часть элемента управления, а не элемент, объявленный в пользовательском интерфейсе приложения. (Унаследовано от RoutedEventArgs)

См. также раздел

• RoutedEventArgs
• MediaFailed
• ImageFailed