XamlParseException Klasse

Definition

Stellt die Ausnahmeklasse für parserspezifische Ausnahmen von einem WPF-XAML-Parser dar. Diese Ausnahme wird in XAML-API- oder WPF-XAML-Parservorgängen von .NET Framework 3.0 und .NET Framework 3.5 oder für die spezifische Verwendung des WPF-XAML-Parsers verwendet, indem XamlReader-API aufgerufen wird.

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 von WPF implementierten XAML-Parser verwendet, der die XAML-Analyse und das Laden für WPF-Anwendungen durchführt. Insbesondere ist die Ausnahme nur relevant, wenn eine Anwendung auf .NET Framework 3.0 und .NET Framework 3.5 ausgerichtet ist. Die Ausnahme kann auch von Benutzercode bei Laufzeitaufrufen an APIs stammen, die den von WPF implementierten XAML-Parser verbinden, um XAML aus einer ausgeführten WPF-Anwendung zu laden (z. B. Aufrufe von XamlReader.Load).

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

Es sei denn, Sie schreiben eine Entsprechung mit dem WPF-XAML-Parser oder arbeiten mit .NET Framework 3.0 und .NET Framework 3.5-Zielbestimmung, sie lösen im Allgemeinen nicht XamlParseException aus Ihrem eigenen Code aus. Die Behandlung für die Ausnahme ist jedoch manchmal erforderlich. In Anwendungsszenarien, in denen Sie XAML-Analysefehler möglicherweise unterdrücken möchten, ist ein DispatcherUnhandledException Ereignishandler auf Anwendungsebene eine Möglichkeit, eine Laufzeit XamlParseExceptionzu behandeln. Unabhängig davon, ob Ausnahmen unterdrückt oder dem Benutzercode angezeigt werden sollen, hängt davon ab, wie Sie Ihre Anwendung für das Laden von XAML entwerfen und welche Vertrauensstufe Sie dem XAML-Code zuweisen, den Sie laden. Weitere Informationen finden Sie im Abschnitt XAML-Sicherheitsüberlegungen oder "XAML-Sicherheit" WPF-.

Bei Seiten einer Anwendung, wenn das XamlParseException ausgelöst wird, befindet es sich in der Regel im Kontext des InitializeComponent Aufrufs der Seitenklasse, der der Einstiegspunkt für die Verwendung des WPF-XAML-Parsers auf Seitenebene ist. Daher ist es eine weitere mögliche Handhabungsstrategie, try/catch Blöcke in InitializeComponentzu platzieren. Diese Technik ist jedoch nicht gut in Vorlagen, visuelle Entwurfsoberflächen und andere generierte Quellen integriert, die InitializeComponentverbinden.

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 mithilfe der angegebenen Ausnahmemeldungszeichenfolge.

XamlParseException(String, Exception)

Initialisiert eine neue Instanz der XamlParseException Klasse, wobei die angegebene Ausnahmemeldungszeichenfolge und innere Ausnahme verwendet wird.

XamlParseException(String, Int32, Int32)

Initialisiert eine neue Instanz der XamlParseException Klasse, wobei die angegebene Ausnahmemeldungszeichenfolge und die angegebene Zeilennummer und Position in der Zeile verwendet werden.

XamlParseException(String, Int32, Int32, Exception)

Initialisiert eine neue Instanz der XamlParseException Klasse, wobei die angegebene Ausnahmemeldung, innere Ausnahme, Zeilennummer und Position in der Zeile verwendet wird.

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

Dient zum Abrufen oder Festlegen eines Links zur Hilfedatei, die dieser Ausnahme zugeordnet ist.

(Geerbt von Exception)
HResult

Dient zum Abrufen oder Festlegen von HRESULT, einem codierten numerischen Wert, der einer bestimmten Ausnahme zugewiesen ist.

(Geerbt von Exception)
InnerException

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

(Geerbt von Exception)
KeyContext

Dient zum Abrufen oder Festlegen des Schlüsselwerts des Elements in einem Wörterbuch, in dem die Ausnahme aufgetreten ist.

LineNumber

Ruft die Zeilennummer ab, in der die Ausnahme aufgetreten ist.

LinePosition

Ruft die Position in der Zeile ab, an der die Ausnahme aufgetreten ist.

Message

Ruft eine Nachricht ab, die die aktuelle Ausnahme beschreibt.

(Geerbt von Exception)
NameContext

Dient zum Abrufen oder Festlegen des XAML-Namens des Objekts, in dem die Ausnahme aufgetreten ist.

Source

Dient zum Abrufen oder Festlegen des Namens der Anwendung oder des Objekts, das den Fehler verursacht.

(Geerbt von Exception)
StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames im Aufrufstapel ab.

(Geerbt von Exception)
TargetSite

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

(Geerbt von Exception)
UidContext

Dient zum Abrufen oder Festlegen der x:Uid-Direktive des Objekts, in dem die Ausnahme aufgetreten ist.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetBaseException()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Exception zurückgegeben, die die Ursache einer oder mehrerer nachfolgenden Ausnahmen ist.

(Geerbt von Exception)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)

Ruft die Daten ab, die zum Serialisieren des angegebenen Objekts erforderlich sind, indem das angegebene SerializationInfo-Objekt auffüllt wird.

GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.

(Geerbt von Exception)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

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

(Geerbt von Exception)

Ereignisse

SerializeObjectState
Veraltet.

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmestatusobjekt zu erstellen, das serialisierte Daten zu der Ausnahme enthält.

(Geerbt von Exception)

Gilt für:

Weitere Informationen