ExceptionRoutedEventArgs Classe

Definição

Namespace:

Microsoft.UI.Xaml

Fornece dados de evento para exceções geradas como eventos por operações assíncronas, como ImageFailed.

public ref class ExceptionRoutedEventArgs : RoutedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

Herança

Object Platform::Object IInspectable RoutedEventArgs ExceptionRoutedEventArgs

Derivado

Microsoft.UI.Xaml.MediaFailedRoutedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

Este exemplo mostra o uso de ExceptionRoutedEventArgs em um manipulador para obter a HResult mensagem de erro e .

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

Comentários

Não exiba cadeias de caracteres ErrorMessage para os usuários finais. Em vez disso, use subcadeias de caracteres e códigos dentro da cadeia de caracteres para identificar positivamente a condição de erro e fazer com que seu aplicativo execute a ação apropriada ou exiba informações apropriadas ao usuário na interface do usuário do aplicativo.

ExceptionRoutedEventArgs são os dados de evento para vários eventos que usam o delegado ExceptionRoutedEventHandler . Estão incluídos:

• Image.ImageFailed
• ImageBrush.ImageFailed
• BitmapImage.ImageFailed
• Windows.UI.Xaml.Controls.MediaElement.MediaFailed (para esse evento, você pode converter os dados do evento para o resultado MediaFailedRoutedEventArgs mais específico).

Classes derivadas de ExceptionRoutedEventArgs

ExceptionRoutedEventArgs é a classe pai de MediaFailedRoutedEventArgs.

Propriedades

ErrorMessage	Obtém o componente de mensagem da exceção, como uma cadeia de caracteres.
OriginalSource	Obtém uma referência ao objeto que gerou o evento. Isso geralmente é uma parte de modelo de um controle em vez de um elemento que foi declarado na interface do usuário do aplicativo. (Herdado de RoutedEventArgs)

Confira também

• RoutedEventArgs
• ImageFailed
• Windows.UI.Xaml.Controls.MediaElement.MediaFailed