XamlReader.ReadSubtree Metoda

Definice

Obor názvů:

System.Xaml

Sestavení:

System.Xaml.dll

XamlReader Vrátí hodnotu založenou na aktuálním XamlReaderobjektu, kde vrácený XamlReader objekt slouží k iteraci podstrom struktury uzlu XAML.

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.XamlReader

Public Overridable Function ReadSubtree () As XamlReader

Návraty

XamlReader

Nová instance čtečky XAML pro podstrom.

Poznámky

Tato metoda má výchozí implementaci a vrací platnou XamlReader. Vrácená XamlReader je interní třída, která omezuje určité XamlReader akce. Omezení jsou konzistentní s účelem čtení pouze kótovaného podstromu většího zdroje pro sadu uzlů XAML a vrácení koncového souboru nebo null aktuálního uzlu při ukončení podstromu.

Obecně platí, že byste měli zkontrolovat aktuální uzel z počátečního Read uzlu a zjistit, jestli potřebujete čtenář podstromu. Jak to zkontrolujete, může to být specifické pro implementaci; vyhněte se však vytváření více čtenářů podstromů pro každý podstrom. Kromě toho se vyhněte vyvolání čtenáře podstromu pro určité případy uzlu (například pro NamespaceDeclaration), které nemohou obsahovat podstrom uzlů.

Po získání čtenáře podstromu musíte volat Read , abyste získali aktuální uzel (nebo volání Skip pro získání dalšího uzlu). Při vytváření nezískat automaticky pozici počátečního uzlu od čtenáře podstromu.

Čtenář, který získáte voláním ReadSubtree z této výchozí implementace, je interní třída. Vnitřní třída zakládá své chování na XamlReader implementaci, která se používá při ReadSubtree zavolání. Účelem interní třídy je zabalit Read obecné chování procházení. Procházení zůstává v zamýšleném podstromu tím, že sleduje StartMember/EndMember páry nebo StartObject/EndObject páry. Také se správně vrátí false pro Read a true pro IsEof to, kdy je čtenář na konci podstromu, jak je definováno jeho vstupním bodem. Obecně předpokládáte, že jakékoli XamlReader rozhraní API, které voláte ze čtečky podstromů, má stejnou implementaci jako celková XamlReader s výjimkou chování při procházení.

ReadSubtree Je však virtuální. Konkrétní XamlReader implementace proto může poskytovat chování, které se liší od interního XamlReader chování obálky; a XamlReader implementace může dokonce zakázat funkce čtečky podstromů vrácením NotImplementedException nebo jinými výjimkami.