Teilen über

XamlReader Klasse

  • Referenz

Definition

Namespace:
System.Xaml
Assembly:
System.Xaml.dll

Stellt Basisdefinitionen für Klassen bereit, die XAML-Eingabe nutzen und XAML-Knotenstreams erzeugen.

public ref class XamlReader abstract : IDisposable
public abstract class XamlReader : IDisposable
type XamlReader = class
    interface IDisposable
Public MustInherit Class XamlReader
Implements IDisposable
Vererbung
Object
XamlReader
Abgeleitet
Implementiert
IDisposable

Hinweise

XamlReader ist eine abstrakte Klasse und stellt keine Implementierungen oder Definitionen bereit, die ein Arbeitsergebnis für alle Member aufweisen. Member, die über eine Implementierung in XamlReader verfügen, werden in den Anmerkungen für dieses Mitglied angegeben. Insbesondere verfügt über mehrere abstrakte Member, XamlReader die implementiert werden müssen, und mehrere virtuelle Member.

Von den virtuellen Membern und Skip stellen jeweils eine Standardimplementierung bereit, ReadSubtree die für die meisten Fälle geeignet ist. Die ReadSubtree Standardimplementierungen und Skip basieren jedoch auf einem anderen erwarteten Verhalten des implementierenden XAML-Readers, insbesondere auf der Read Außerkraftsetzung. Dispose ist auch ein virtuelles Element, das über eine funktionierende Standardimplementierung verfügt.

Die folgenden beiden Klassen sind die relevantesten und praktischsten abgeleiteten Klassen in .NET Framework XAML-Diensten und der System.Xaml-Assembly:

  • XamlObjectReader, das einen Objektgraphen liest, z. B. den aktiven Objektgraphen einer Anwendung zur Laufzeit.

  • XamlXmlReader, das XAML in Form einer XML-Textdatei liest, indem eine allgemeine XmlReader datei verwendet wird, die die Datei als zwischengeschaltete Hilfsklasse lädt.

Andere XAML-Reader aus anderen Frameworks sind Baml2006Reader und XamlDebuggerXmlReader.

XamlReader unterscheidet sich von XML-DOM-Prinzipien (Document Object Model) und XmlReader Entwurfsprinzipien, da XamlReader keine Create Methode zum Zurückgeben zugrunde liegender STANDARD-XAML-Readerimplementierungen vorhanden ist. Stattdessen müssen Sie bestimmte abgeleitete XAML-Readerklassen instanziieren, indem Sie deren Konstruktoren oder andere klassenspezifische Hilfs-APIs aufrufen.

Unterstrukturleser

In den meisten Fällen rufen XamlReader Sie die API im Kontext bestimmter XAML-Readerklassen auf, die von abgeleitet werden XamlReader. In einem bestimmten Fall greifen XamlReader Sie jedoch auf die API auf einer praktischen XAML-Readerinstanz zu, die nicht öffentlich und nicht von XamlObjectReader oder XamlXmlReaderabgeleitet ist. Dieser Fall ist, wenn Sie aufrufen ReadSubtree, wodurch eine XamlReader -Instanz zurückgegeben wird. In der Standardimplementierung ist die, die XamlReader von dieser API zurückgegeben wird, eine interne Klasse.

Das XamlReader zum Lesen von Unterstrukturen abgerufene verfügt über gültige Aktionen für APIs wie Read und NodeType, und diese Aktionen basieren auf der übergeordneten Leserklasse. Dieser Entwurf ermöglicht es der internen Klasse, die Frameebene nachzuverfolgen, auf der die Teilstruktur eingegeben wurde. Die handelnde Unterstruktur XamlReader stellt sicher, dass, wenn die aktuelle Knotenposition über die Grenzen der Unterstruktur verschoben wird, der spezifische Teilstrukturleser das Ende der Datei oder null am aktuellen Knoten meldet.

Hinweise zur Verwendung von Unterstrukturleseberechtigten sind auf bestimmten XamlReader APIs enthalten.

Konstruktoren

XamlReader()

Initialisiert die XamlReader-Klasse.

Eigenschaften

IsDisposed

Ruft ab, ob die Dispose(Boolean)-Methode aufgerufen wurde.
IsEof

Bei der Implementierung in einer abgeleiteten Klasse wird ein Wert abgerufen, durch den angegeben wird, ob sich die Readerposition am Dateiende befindet.
Member

Bei der Implementierung in einer abgeleiteten Klasse wird der aktuelle Member an der Readerposition abgerufen, wenn sich die Readerposition in einem StartMember-Feld befindet.
Namespace

Ruft bei der Implementierung in einer abgeleiteten Klasse die XAML-Namespaceinformationen aus dem aktuellen Knoten ab.
NodeType

Ruft beim Implementieren in einer abgeleiteten Klasse den Typ des aktuellen Knotens ab.
SchemaContext

Ruft beim Implementieren in einer abgeleiteten Klasse ein Objekt ab, das XAML-Schemakontextinformationen für den Informationssatz bereitstellt.
Type

Ruft beim Implementieren in einer abgeleiteten Klasse das XamlType-Objekt des aktuellen Knotens ab.
Value

Ruft beim Implementieren in einer abgeleiteten Klasse den Wert des aktuellen Knotens ab.

Methoden

Close()

Schließt den XAML-Knotenstream.
Dispose(Boolean)

Gibt die von der XamlReader-Klasse verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
Read()

Bei der Implementierung in einer abgeleiteten Klasse wird der nächste XAML-Knoten aus der Quelle bereitgestellt, wenn ein Knoten verfügbar ist.
ReadSubtree()

Gibt ein XamlReader-Objekt auf Grundlage des aktuellen XamlReader-Objekts zurück, bei dem das zurückgegebene XamlReader-Objekt zum Durchlaufen einer Teilstruktur der XAML-Knotenstruktur verwendet wird.
Skip()

Überspringt den aktuellen Knoten und verschiebt die Readerposition weiter zum nächsten Knoten.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Gibt alle von der aktuellen Instanz der XamlReader-Klasse verwendeten Ressourcen frei.

Gilt für:

Weitere Informationen