ExceptionRoutedEventArgs Classe

Definição

Namespace:

Windows.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(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

Herança

Object Platform::Object IInspectable RoutedEventArgs ExceptionRoutedEventArgs

Derivado

Windows.UI.Xaml.MediaFailedRoutedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

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

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
• 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
• MediaFailed
• ImageFailed