ExceptionRoutedEventArgs Klasse

Referenz

Definition

Namespace:: Microsoft.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(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

Vererbung: Object Platform::Object IInspectable RoutedEventArgs ExceptionRoutedEventArgs

Abgeleitet: Microsoft.UI.Xaml.MediaFailedRoutedEventArgs

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Dieses Beispiel zeigt die Verwendung von ExceptionRoutedEventArgs in einem Handler, um die HResult Fehlermeldung und 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 in der Zeichenfolge, um die Fehlerbedingung positiv zu identifizieren, und lassen Sie Ihre App geeignete Maßnahmen ergreifen oder benutzergerechte Informationen auf der App-Benutzeroberfläche anzeigen.

ExceptionRoutedEventArgs ist die Ereignisdaten für mehrere Ereignisse, die den Delegaten ExceptionRoutedEventHandler verwenden. Dazu zählen unter anderem folgende Einstellungen:

Image.ImageFailed
ImageBrush.ImageFailed
BitmapImage.ImageFailed
Windows.UI.Xaml.Controls.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 Ihrer App-Benutzeroberfläche deklariert wurde. (Geerbt von RoutedEventArgs)

Gilt für:

Freigeben über