XamlParseException Klasse
Definition
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.
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
- 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 InitializeComponent
zu platzieren. Diese Technik ist jedoch nicht gut in Vorlagen, visuelle Entwurfsoberflächen und andere generierte Quellen integriert, die InitializeComponent
verbinden.
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) |