ExceptionRoutedEventArgs Classe

Référence

Définition

Espace de noms:: Windows.UI.Xaml

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Fournit des données d’événement pour les exceptions qui sont déclenchées en tant qu’événements par des opérations asynchrones, telles que 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

Héritage: Object Platform::Object IInspectable RoutedEventArgs ExceptionRoutedEventArgs

Dérivé: Windows.UI.Xaml.MediaFailedRoutedEventArgs

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple montre l’utilisation d’ExceptionRoutedEventArgs dans un gestionnaire afin d’obtenir le HResult et le message d’erreur.

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

Remarques

N’affichez pas de chaînes ErrorMessage pour les utilisateurs finaux. Au lieu de cela, utilisez des sous-chaînes et des codes dans la chaîne pour identifier positivement la condition d’erreur et faire en ce que votre application prenne les mesures appropriées ou affiche les informations appropriées à l’utilisateur dans l’interface utilisateur de l’application.

ExceptionRoutedEventArgs est les données d’événement de plusieurs événements qui utilisent le délégué ExceptionRoutedEventHandler . Il s’agit notamment des paramètres suivants :

Image.ImageFailed
ImageBrush.ImageFailed
BitmapImage.ImageFailed
MediaElement.MediaFailed; pour cet événement, vous pouvez caster les données d’événement vers le résultat MediaFailedRoutedEventArgs plus spécifique.

Classes dérivées ExceptionRoutedEventArgs

ExceptionRoutedEventArgs est la classe parente de MediaFailedRoutedEventArgs.

Propriétés

ErrorMessage	Obtient le composant de message de l’exception, sous forme de chaîne.
OriginalSource	Obtient une référence à l’objet qui a déclenché l’événement. Il s’agit souvent d’une partie de modèle d’un contrôle plutôt que d’un élément qui a été déclaré dans l’interface utilisateur de votre application. (Hérité de RoutedEventArgs)

S’applique à

Partager via