XamlParseException Klasse

Definition

Stellt die Ausnahmeklasse für parserspezifische Ausnahmen eines WPF-XAML-Parsers dar. Diese Ausnahme wird in XAML-API- oder WPF-XAML-Parservorgängen in .NET Framework 3.0 und .NET Framework 3.5 verwendet, oder sie ist für die spezifische Verwendung des WPF-XAML-Parsers durch Aufrufen der XamlReader-API bestimmt.

public ref class XamlParseException : SystemException
[System.Serializable]
public class XamlParseException : SystemException
public class XamlParseException : SystemException
[<System.Serializable>]
type XamlParseException = class
    inherit SystemException
type XamlParseException = class
    inherit SystemException
Public Class XamlParseException
Inherits SystemException
Vererbung
XamlParseException
Attribute

Hinweise

XamlParseException wird nur für den in WPF implementierten XAML-Parser verwendet, der die XAML-Analyse und das Laden für WPF-Anwendungen ausführt. Insbesondere ist die Ausnahme nur relevant, wenn eine Anwendung auf .NET Framework 3.0 und .NET Framework 3.5 abzielt. Die Ausnahme kann auch aus Benutzercode in Laufzeitaufrufen von APIs stammen, die den in WPF implementierten XAML-Parser einbinden, um XAML aus einer ausgeführten WPF-Anwendung zu laden (z. B. Aufrufe von XamlReader.Load).

Für .NET Framework 4 wird die Ausnahme, die XamlParseException normalerweise XAML-Verarbeitungsausnahmen meldet, in einem anderen Namespace (System.Xaml) und einer anderen Assembly (System.Xaml) definiert.

Wenn Sie keine Entsprechung mit dem WPF-XAML-Parser schreiben oder mit .NET Framework 3.0 und .NET Framework 3.5-Zielziel arbeiten, werden Sie in der Regel nicht aus Ihrem eigenen Code auslösenXamlParseException. Die Behandlung der Ausnahme ist jedoch manchmal erforderlich. Für Anwendungsszenarien, in denen Sie XAML-Analysefehler unterdrücken möchten, ist ein DispatcherUnhandledException Ereignishandler auf Anwendungsebene eine Möglichkeit, eine Laufzeit XamlParseExceptionzu verarbeiten. Ob Ausnahmen unterdrückt oder für Benutzercode angezeigt werden sollen, hängt davon ab, wie Sie Ihre Anwendung zum Laden von XAML entwerfen und welche Vertrauensstufe Sie dem XAML-Ladevorgang zuweisen. Weitere Informationen finden Sie unter XAML-Sicherheitsüberlegungen oder abschnitt "XAML-Sicherheit" der XAML-Übersicht (WPF).

Wenn für Seiten einer Anwendung ausgelöst wird, erfolgt dies XamlParseException in der Regel im Kontext des InitializeComponent Aufrufs ihrer Seitenklasse. Dies ist der Einstiegspunkt für die Verwendung des WPF-XAML-Parsers im WPF-Anwendungsmodell auf Seitenebene. Daher ist eine weitere mögliche Behandlungsstrategie das Platzieren von try/catch Blöcken in InitializeComponent. Diese Technik lässt sich jedoch nicht gut in Vorlagen, visuelle Entwurfsoberflächen und andere generierte Quellen integrieren, die eingebunden InitializeComponentwerden.

Konstruktoren

XamlParseException()

Initialisiert eine neue Instanz der XamlParseException-Klasse.

XamlParseException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der XamlParseException-Klasse.

XamlParseException(String)

Initialisiert eine neue Instanz der XamlParseException-Klasse mit der angegebenen Ausnahmemeldungszeichenfolge.

XamlParseException(String, Exception)

Initialisiert eine neue Instanz der XamlParseException-Klasse mit der angegebenen Meldungszeichenfolge und der angegebenen internen Ausnahme.

XamlParseException(String, Int32, Int32)

Initialisiert eine neue Instanz der XamlParseException-Klasse mit der angegebenen Ausnahmemeldungszeichenfolge und der angegebenen Zeilennummer und Position in der Zeile.

XamlParseException(String, Int32, Int32, Exception)

Initialisiert eine neue Instanz der XamlParseException-Klasse mit der angegebenen Ausnahmemeldung, inneren Ausnahme, Zeilennummer und Position in der Zeile.

Eigenschaften

BaseUri

Ruft Basis-URI-Informationen ab, wenn die Ausnahme ausgelöst wird.

Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen.

(Geerbt von Exception)
HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.

(Geerbt von Exception)
HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.

(Geerbt von Exception)
InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.

(Geerbt von Exception)
KeyContext

Ruft den -Schlüsselwert des Elements in einem Wörterbuch fest, in dem die Ausnahme aufgetreten ist, oder legt diesen Wert fest.

LineNumber

Ruft die Nummer der Zeile ab, in der die Ausnahme aufgetreten ist.

LinePosition

Ruft die Position auf der Zeile ab, in der die Ausnahme aufgetreten ist, oder legt sie fest.

Message

Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird.

(Geerbt von Exception)
NameContext

Ruft den XAML-Namen des Objekts ab, in dem die Ausnahme aufgetreten ist, oder legt diesen Namen fest.

Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.

(Geerbt von Exception)
StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.

(Geerbt von Exception)
TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.

(Geerbt von Exception)
UidContext

Ruft die x:Uid Directivede Objekts ab, in dem die Ausnahme aufgetreten ist, oder legt sie fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist.

(Geerbt von Exception)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)

Ruft die zum Serialisieren des angegebenen Objekts durch Auffüllen des angegebenen SerializationInfo-Objekts erforderlichen Daten ab.

GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.

(Geerbt von Exception)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.

(Geerbt von Exception)

Ereignisse

SerializeObjectState
Veraltet.

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.

(Geerbt von Exception)

Gilt für:

Weitere Informationen