XamlReader.ReadSubtree Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een XamlReader die is gebaseerd op de huidige XamlReader, waarbij het geretourneerde XamlReader wordt gebruikt om door een substructuur van de XAML-knooppuntstructuur te doorlopen.
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 XamlReaderRetouren
Een nieuw XAML-lezerexemplaren voor de substructuur.
Opmerkingen
Deze methode heeft een standaard implementatie en retourneert een geldige XamlReader. De geretourneerde XamlReader klasse is een interne klasse die bepaalde XamlReader acties beperkt. De beperkingen zijn consistent met het doel om alleen een gedimensioneerde substructuur van een grotere bron voor een XAML-knooppuntset te lezen en het einde van het bestand of null op het huidige knooppunt te retourneren wanneer de substructuur wordt afgesloten.
Over het algemeen moet u het huidige knooppunt vanaf het begin Read controleren om te bepalen of u een substructuurlezer nodig hebt. Hoe u dit controleert, is mogelijk implementatiespecifiek; Vermijd echter het maken van meerdere substructuurlezers voor elke substructuur. Vermijd bovendien het aanroepen van een substructuurlezer voor bepaalde knooppuntcases (bijvoorbeeld bijvoorbeeld) NamespaceDeclarationdie geen substructuur van knooppunten kunnen bevatten.
Nadat u een substructuurlezer hebt verkregen, moet u deze aanroepen Read om een huidig knooppunt te verkrijgen (of om Skip een volgend knooppunt te verkrijgen). U verkrijgt niet automatisch een eerste knooppuntpositie van de substructuurlezer wanneer u deze maakt.
De lezer die u verkrijgt door deze standaard implementatie aan te roepen ReadSubtree , is een interne klasse. De interne klasse baseert zijn gedrag op de XamlReader implementatie die wordt gebruikt wanneer ReadSubtree wordt aangeroepen. Het doel van de interne klasse is om het Read en algemene doorkruisingsgedrag te verpakken. De doorkruising blijft binnen de beoogde substructuur door paren of StartObject/EndObject paren bij StartMember/EndMember te houden. Het retourneert false ook correct voor Read en true voor IsEof wanneer de lezer zich aan het einde van de substructuur bevindt, zoals gedefinieerd door het toegangspunt. Over het algemeen gaat u ervan uit dat elke XamlReader API die u aanroept van een substructuurlezer dezelfde implementatie heeft als het algemene XamlReader , met uitzondering van het doorkruisingsgedrag.
ReadSubtree Is echter virtueel. Daarom kan een specifieke XamlReader implementatie gedrag bieden dat verschilt van het XamlReader interne wrapper-gedrag; en een XamlReader implementatie kan zelfs de functionaliteit van substructuurlezers uitschakelen door terug te keren NotImplementedException of andere uitzonderingen.