ExceptionRoutedEventArgs Klasse

Referenz

Definition

Namespace:: Windows.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt Ereignisdaten für Ausnahmen bereit, die von asynchronen Vorgängen wie ImageFailed als Ereignisse ausgelöst werden.

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

Vererbung: Object Platform::Object IInspectable RoutedEventArgs ExceptionRoutedEventArgs

Abgeleitet: Windows.UI.Xaml.MediaFailedRoutedEventArgs

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Dieses Beispiel zeigt die Verwendung von ExceptionRoutedEventArgs in einem Handler, um das HResult und die Fehlermeldung abzurufen.

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

Hinweise

Zeigen Sie Den Endbenutzern keine ErrorMessage-Zeichenfolgen an. Verwenden Sie stattdessen Teilzeichenfolgen und Codes innerhalb der Zeichenfolge, um die Fehlerbedingung positiv zu identifizieren, und lassen Sie Ihre App entsprechende Maßnahmen ergreifen oder benutzergerechte Informationen auf der App-Benutzeroberfläche anzeigen.

ExceptionRoutedEventArgs ist die Ereignisdaten für mehrere Ereignisse, die den ExceptionRoutedEventHandler-Delegaten verwenden. Dazu gehören:

Image.ImageFailed
ImageBrush.ImageFailed
BitmapImage.ImageFailed
MediaElement.MediaFailed; Für dieses Ereignis können Sie die Ereignisdaten in das spezifischere MediaFailedRoutedEventArgs-Ergebnis umwandeln.

Abgeleitete ExceptionRoutedEventArgs-Klassen

ExceptionRoutedEventArgs ist die übergeordnete Klasse für MediaFailedRoutedEventArgs.

Eigenschaften

ErrorMessage	Ruft die Nachrichtenkomponente der Ausnahme als Zeichenfolge ab.
OriginalSource	Ruft einen Verweis auf das -Objekt ab, das das -Ereignis ausgelöst hat. Dies ist häufig ein Vorlagenteil eines Steuerelements und nicht ein Element, das in der App-Benutzeroberfläche deklariert wurde. (Geerbt von RoutedEventArgs)

Gilt für:

Freigeben über