XamlReader XamlReader XamlReader XamlReader Class

Definition

Stellt Basisdefinitionen für Klassen bereit, die XAML-Eingabe nutzen und XAML-Knotenstreams erzeugen.Provides base definitions for classes that consume XAML input and produce XAML node streams.

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

Hinweise

XamlReader ist eine abstrakte Klasse, und bietet keine Implementierungen oder Definitionen, die ein Ergebnis der Arbeiten für alle Elemente aufweisen.XamlReader is an abstract class and does not provide implementations or definitions that have a working result for all members. Elemente, die eine Implementierung, in verfügen XamlReader sind in den Hinweisen für diesen Member aufgeführt.Members that do have an implementation in XamlReader are noted in the remarks for that member. Insbesondere XamlReader verfügt über mehrere abstrakte Member, die implementiert werden müssen, und mehrere virtuelle Member.Specifically, XamlReader has several abstract members that must be implemented, and several virtual members.

Der virtuelle Elemente ReadSubtree und Skip jedes bieten eine Standardimplementierung, die in den meisten Fällen geeignet ist.Of the virtual members, ReadSubtree and Skip each provide a default implementation that is appropriate for most cases. Allerdings die ReadSubtree und Skip standardimplementierungen andere erwarteten Verhaltens der von der implementierenden XAML-Reader abhängig sein, insbesondere sie verlassen sich auf die Read außer Kraft setzen.However, the ReadSubtree and Skip default implementations rely on other expected behavior of the implementing XAML reader; in particular, they rely on the Read override. Dispose ist auch ein virtueller Member, der über eine funktionierende-Standardimplementierung verfügt.Dispose is also a virtual member that has a working default implementation.

Die folgenden beiden Klassen sind die relevantesten und praktischen abgeleiteten Klassen in .NET Framework-XAML-Dienste und der System.Xaml-Assembly:The following two classes are the most relevant and practical derived classes in .NET Framework XAML Services and the System.Xaml assembly:

  • XamlObjectReader, die ein Objektdiagramm, wie z. B. das aktive Objektdiagramm einer Anwendung zur Laufzeit lesen.XamlObjectReader, which reads an object graph, such as the active object graph of an application at run time.

  • XamlXmlReader, die XAML in Form einer XML-Textdatei mit einer allgemeinen lesen XmlReader , lädt die Datei als ein Vermittler Hilfsklasse.XamlXmlReader, which reads XAML in the form of a XML text file by using a general XmlReader that loads the file as an intermediary helper class.

Andere XAML-Reader, aus anderen Frameworks enthalten Baml2006Reader und XamlDebuggerXmlReader.Other XAML readers from other frameworks include Baml2006Reader and XamlDebuggerXmlReader.

XamlReader unterscheidet sich von XML-Dokumentobjektmodell (DOM)XML Document Object Model (DOM) und XmlReader Entwurfsprinzipien, da XamlReader verfügt nicht über eine Create Methode, um zugrunde liegende standardmäßigen XAML-readerimplementierungen zurückzugeben.XamlReader differs from XML-Dokumentobjektmodell (DOM)XML Document Object Model (DOM) and XmlReader design principles because XamlReader does not have a Create method to return underlying default XAML reader implementations. Sie müssen stattdessen bestimmte abgeleitete Klassen für XAML-Reader instanziieren, indem Sie ihre Konstruktoren oder andere mandantenklassen geltenden schemaanpassungen Hilfs-APIs aufrufen.You must instead instantiate specific derived XAML reader classes by calling their constructors or other class-specific helper APIs.

Teilstruktur LeserSubtree Readers

Rufen Sie zum größten Teil, XamlReader API im Kontext der bestimmten XAML-Reader-Klassen, die von abgeleitet XamlReader.For the most part, you call XamlReader API in the context of specific XAML reader classes that derive from XamlReader. Sie können jedoch in einem speziellen Fall zugreifen XamlReader -API in einem praktischen XAML-Reader-Instanz, die nicht öffentlichen und nicht abgeleitet ist XamlObjectReader oder XamlXmlReader.However, in one particular case, you access XamlReader API on a practical XAML reader instance that is not public and not derived from XamlObjectReader or XamlXmlReader. Dieser Fall ist, beim Aufrufen ReadSubtree, gibt eine XamlReader Instanz.This case is when you call ReadSubtree, which returns a XamlReader instance. In der Standardimplementierung der XamlReader , von dieser API zurückgegebenen ist eine interne Klasse.In the default implementation, the XamlReader that is returned by this API is an internal class.

Die XamlReader abgerufen, für die Teilstruktur lesen gültige Aktionen für APIs verfügt, z. B. Read und NodeType, und diese Aktionen hängen von der übergeordneten Klasse von Ressourcenreadern.The XamlReader obtained for subtree reading has valid actions for APIs such as Read and NodeType, and those actions are based on the parent reader class. Dieser Entwurf ermöglicht die interne Klasse, um die Frame-Ebene nachzuverfolgen, in die Teilstruktur eingegeben wurde.This design enables the internal class to track the frame level where the subtree was entered. Die Teilstruktur fungiert XamlReader stellt sicher, dass der Reader bestimmte Unterstruktur EOF, wenn die aktuellen Knotenposition außerhalb des zulässigen Bereichs der Teilstruktur verschoben wird meldet, oder null am aktuellen Knoten.The acting subtree XamlReader makes sure that if the current node position is moved beyond the bounds of the subtree, the specific subtree reader reports end-of-file or null at the current node.

Hinweise zur Nutzung von Teilstruktur Reader befinden sich auf bestimmte XamlReader APIs.Notes about subtree reader usage are included on certain XamlReader APIs.

Konstruktoren

XamlReader() XamlReader() XamlReader() XamlReader()

Initialisiert die XamlReader-Klasse.Initializes the XamlReader class.

Eigenschaften

IsDisposed IsDisposed IsDisposed IsDisposed

Ruft ab, ob die Dispose(Boolean)-Methode aufgerufen wurde.Gets whether Dispose(Boolean) has been called.

IsEof IsEof IsEof IsEof

Bei der Implementierung in einer abgeleiteten Klasse wird ein Wert abgerufen, durch den angegeben wird, ob sich die Readerposition am Dateiende befindet.When implemented in a derived class, gets a value that reports whether the reader position is at end-of-file.

Member Member Member 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.When implemented in a derived class, gets the current member at the reader position, if the reader position is on a StartMember.

Namespace Namespace Namespace Namespace

Ruft bei der Implementierung in einer abgeleiteten Klasse die XAML-Namespaceinformationen aus dem aktuellen Knoten ab.When implemented in a derived class, gets the XAML namespace information from the current node.

NodeType NodeType NodeType NodeType

Ruft beim Implementieren in einer abgeleiteten Klasse den Typ des aktuellen Knotens ab.When implemented in a derived class, gets the type of the current node.

SchemaContext SchemaContext SchemaContext SchemaContext

Ruft beim Implementieren in einer abgeleiteten Klasse ein Objekt ab, das XAML-Schemakontextinformationen für den Informationssatz bereitstellt.When implemented in a derived class, gets an object that provides XAML schema context information for the information set.

Type Type Type Type

Ruft beim Implementieren in einer abgeleiteten Klasse das XamlType-Objekt des aktuellen Knotens ab.When implemented in a derived class, gets the XamlType of the current node.

Value Value Value Value

Ruft beim Implementieren in einer abgeleiteten Klasse den Wert des aktuellen Knotens ab.When implemented in a derived class, gets the value of the current node.

Methoden

Close() Close() Close() Close()

Schließt den XAML-Knotenstream.Closes the XAML node stream.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von der XamlReader-Klasse verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the XamlReader, and optionally, releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Read() Read() Read() Read()

Bei der Implementierung in einer abgeleiteten Klasse wird der nächste XAML-Knoten aus der Quelle bereitgestellt, wenn ein Knoten verfügbar ist.When implemented in a derived class, provides the next XAML node from the source, if a node is available.

ReadSubtree() ReadSubtree() ReadSubtree() 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.Returns a XamlReader that is based on the current XamlReader, where the returned XamlReader is used to iterate through a subtree of the XAML node structure.

Skip() Skip() Skip() Skip()

Überspringt den aktuellen Knoten und verschiebt die Readerposition weiter zum nächsten Knoten.Skips the current node and advances the reader position to the next node.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Gibt alle von der aktuellen Instanz der XamlReader-Klasse verwendeten Ressourcen frei.Releases all resources used by the current instance of the XamlReader class.

Gilt für:

Siehe auch