XamlReader.ReadSubtree Methode
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.
Gibt ein XamlReader , das auf dem aktuellen XamlReaderbasiert, wobei die zurückgegebene XamlReader Wird verwendet wird, um eine Unterstruktur der XAML-Knotenstruktur zu durchlaufen.
public:
virtual System::Xaml::XamlReader ^ ReadSubtree();public virtual System.Xaml.XamlReader ReadSubtree();abstract member ReadSubtree : unit -> System.Xaml.XamlReader
override this.ReadSubtree : unit -> System.Xaml.XamlReaderPublic Overridable Function ReadSubtree () As XamlReaderGibt zurück
Eine neue XAML-Reader-Instanz für die Unterstruktur.
Hinweise
Diese Methode verfügt über eine Standardimplementierung und gibt einen gültigen XamlReaderWert zurück. Die zurückgegebene XamlReader Klasse ist eine interne Klasse, die bestimmte XamlReader Aktionen einschränkt. Die Einschränkungen entsprechen dem Zweck, nur eine dimensionierte Unterstruktur einer größeren Quelle für einen XAML-Knotensatz zu lesen und das Ende der Datei oder null am aktuellen Knoten zurückzugeben, wenn die Unterstruktur beendet wird.
Im Allgemeinen sollten Sie den aktuellen Knoten von der Initiale Read überprüfen, um zu ermitteln, ob Sie einen Unterstrukturleser benötigen. Wie Sie dies überprüfen, kann implementierungsspezifisch sein; Vermeiden Sie jedoch das Erstellen mehrerer Unterstrukturleser für jede Unterstruktur. Vermeiden Sie außerdem das Aufrufen eines Unterstrukturlesers für bestimmte Knotenfälle (z. B. für NamespaceDeclaration) die keine Unterstruktur von Knoten enthalten kann.
Nachdem Sie einen Unterstrukturleser erhalten haben, müssen Sie ihn aufrufen Read , um einen aktuellen Knoten (oder einen Aufruf Skip zum Abrufen eines nächsten Knotens) abzurufen. Sie erhalten beim Erstellen nicht automatisch eine anfängliche Knotenposition vom Unterstrukturleser.
Der Leser, den Sie durch Aufrufen dieser Standardimplementierung ReadSubtree abrufen, ist eine interne Klasse. Die interne Klasse basiert auf dem Verhalten der XamlReader Implementierung, die beim ReadSubtree Aufrufen verwendet wird. Der Zweck der internen Klasse besteht darin, das Read allgemeine Traversalverhalten umzuschließen. Die Traversal bleibt innerhalb der vorgesehenen Unterstruktur, indem Sie Paare StartMember/EndMember oder StartObject/EndObject Paare nachverfolgen. Es wird auch korrekt zurückgegeben false für Read und true für IsEof den Zeitpunkt, an dem sich der Leser am Ende der Unterstruktur befindet, wie durch seinen Einstiegspunkt definiert. Im Allgemeinen gehen Sie davon aus, dass alle XamlReader API, die Sie von einem Unterstrukturleser aufrufen, über dieselbe Implementierung wie die allgemeine XamlReader Implementierung mit Ausnahme des durchquerenden Begrenzungsverhaltens verfügt.
ReadSubtree Ist jedoch virtuell. Daher kann eine bestimmte XamlReader Implementierung Verhaltensweisen bereitstellen, die sich vom XamlReader internen Wrapperverhalten unterscheiden, und eine XamlReader Implementierung kann sogar die Funktionalität des Unterstrukturlesers durch Zurückgeben NotImplementedException oder andere Ausnahmen deaktivieren.
