SiteMapPath.CreateControlHierarchy Methode

Definition

Überprüft die von SiteMapProvider bereitgestellte Siteübersichtsstruktur und erstellt eine Auflistung untergeordneter Steuerelemente basierend auf den für die funktionalen Knoten definierten Stilen und Vorlagen.Examines the site map structure provided by the SiteMapProvider and builds a child controls collection based on the styles and templates defined for the functional nodes.

protected:
 virtual void CreateControlHierarchy();
protected virtual void CreateControlHierarchy ();
abstract member CreateControlHierarchy : unit -> unit
override this.CreateControlHierarchy : unit -> unit
Protected Overridable Sub CreateControlHierarchy ()

Ausnahmen

Für das SiteMapProvider-Steuerelement ist kein SiteMapPath verfügbar.No SiteMapProvider is available to the SiteMapPath control.

Hinweise

Mit der CreateControlHierarchy-Methode werden SiteMapNodeItem Steuerelemente erstellt, den entsprechenden SiteMapNode Objekten aus dem aktuellen Site Übersichts Anbieter zugeordnet und die Knoten der Controls Auflistung hinzugefügt.The CreateControlHierarchy method creates SiteMapNodeItem controls, associates them with the corresponding SiteMapNode objects from the current site map provider, and adds the nodes to the Controls collection.

Die Methode beginnt mit der Suche nach dem SiteMap.CurrentNodeund durchläuft dann die hierarchische Struktur von SiteMapNode Objekten und erstellt eine SiteMapNodeItem für jeden, bis die RootNode erreicht wird.The method begins by finding the SiteMap.CurrentNode, and then walks up the hierarchical tree of SiteMapNode objects, creating a SiteMapNodeItem for each one until the RootNode is reached. Nachdem jede SiteMapNodeItem erstellt, aber bevor Sie an den entsprechenden SiteMapNodegebunden ist, wird die InitializeItem-Methode aufgerufen.After each SiteMapNodeItem is created, but before it is bound to its corresponding SiteMapNode, the InitializeItem method is called. Die InitializeItem-Methode wendet alle für einen bestimmten Knotentyp definierten Vorlagen oder Stile an und erstellt und initialisiert alle untergeordneten Steuerelemente, die die SiteMapNodeItem enthält.The InitializeItem method applies any templates or styles defined for a particular node type and creates and initializes any child controls that the SiteMapNodeItem contains. Schließlich fügt die InitializeItem-Methode die untergeordneten Steuerelemente der SiteMapNodeItem der Controls-Auflistung hinzu.Finally, the InitializeItem method adds the child controls of the SiteMapNodeItem to the Controls collection.

Nachdem jede SiteMapNodeItem initialisiert wurde, wird die OnItemCreated-Methode aufgerufen.After each SiteMapNodeItem is initialized, the OnItemCreated method is called. Anschließend wird der SiteMapNodeItem an den entsprechenden SiteMapNodegebunden, und OnDataBound wird aufgerufen.Then the SiteMapNodeItem is bound to its corresponding SiteMapNode, and OnDataBound is called.

Die CreateControlHierarchy-Methode wird von der CreateChildControls-Methode aufgerufen.The CreateControlHierarchy method is called from the CreateChildControls method.

Klassen, die das SiteMapPath Steuerelement erweitern, überschreiben die CreateControlHierarchy-Methode, um zu ändern, wie die SiteMapNodeItem Steuerelemente erstellt oder dem SiteMapPath Steuerelement hinzugefügt werdenClasses that extend the SiteMapPath control override the CreateControlHierarchy method to alter how the SiteMapNodeItem controls are created or added to the SiteMapPath control. Die Bearbeitung einzelner Knoten Elemente wird in der InitializeItem-Methode ausgeführt, und die meisten Klassen, die erweitern SiteMapPath überschreiben diese Methode.The manipulation of individual node items is performed in the InitializeItem method, and most classes that extend SiteMapPath override that method only.

Gilt für:

Siehe auch