SiteMapPath.CreateControlHierarchy 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.
Bekijkt de siteoverzichtstructuur die wordt geleverd door de SiteMapProvider en bouwt een verzameling onderliggende besturingselementen op basis van de stijlen en sjablonen die zijn gedefinieerd voor de functionele knooppunten.
protected:
virtual void CreateControlHierarchy();protected virtual void CreateControlHierarchy();abstract member CreateControlHierarchy : unit -> unit
override this.CreateControlHierarchy : unit -> unitProtected Overridable Sub CreateControlHierarchy ()Uitzonderingen
Nee SiteMapProvider is beschikbaar voor het SiteMapPath besturingselement.
Opmerkingen
Met CreateControlHierarchy de methode worden besturingselementen gemaakt SiteMapNodeItem , gekoppeld aan de bijbehorende SiteMapNode objecten van de huidige siteoverzichtprovider en worden de knooppunten toegevoegd aan de Controls verzameling.
De methode begint met het vinden van de SiteMap.CurrentNodeen vervolgens de hiërarchische structuur van SiteMapNode objecten, waarbij een SiteMapNodeItem voor elk object wordt gemaakt totdat het RootNode is bereikt. Nadat elke SiteMapNodeItem is gemaakt, maar voordat deze is gebonden aan de bijbehorende SiteMapNode, wordt de InitializeItem methode aangeroepen. De InitializeItem methode past sjablonen of stijlen toe die zijn gedefinieerd voor een bepaald knooppunttype en maakt en initialiseert onderliggende besturingselementen die de SiteMapNodeItem bevat. Ten slotte voegt de InitializeItem methode de onderliggende besturingselementen van de SiteMapNodeItemControls verzameling toe.
Nadat elke SiteMapNodeItem methode is geïnitialiseerd, wordt de OnItemCreated methode aangeroepen. Vervolgens is het afhankelijk van de SiteMapNodeItem bijbehorende SiteMapNodeen OnDataBound wordt aangeroepen.
De CreateControlHierarchy methode wordt aangeroepen vanuit de CreateChildControls methode.
Klassen die het SiteMapPath besturingselement uitbreiden, overschrijven de CreateControlHierarchy methode om te wijzigen hoe de SiteMapNodeItem besturingselementen worden gemaakt of toegevoegd aan het SiteMapPath besturingselement. De manipulatie van afzonderlijke knooppuntitems wordt uitgevoerd in de InitializeItem methode en de meeste klassen die deze methode alleen overschrijven SiteMapPath .