SiteMapPath.CreateControlHierarchy Metodo

Definizione

Esamina la struttura della mappa del sito fornita da SiteMapProvider e compila un insieme di controlli figlio basato sugli stili e sui modelli definiti per i nodi funzionali.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 ()

Eccezioni

Non è disponibile alcuna proprietà SiteMapProvider per il controllo SiteMapPath.No SiteMapProvider is available to the SiteMapPath control.

Commenti

Il CreateControlHierarchy metodo crea SiteMapNodeItem controlli, li associa ai corrispondenti SiteMapNode oggetti dal Controls provider della mappa del sito corrente e aggiunge i nodi alla raccolta.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.

Il metodo inizia individuando l' SiteMap.CurrentNodeoggetto e quindi esamina la struttura ad albero gerarchica SiteMapNode degli oggetti, creando SiteMapNodeItem un oggetto per ciascuno di RootNode essi finché non viene raggiunto il valore.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. Dopo la SiteMapNodeItem creazione di ogni, ma prima che venga associato al corrispondente SiteMapNode, viene InitializeItem chiamato il metodo.After each SiteMapNodeItem is created, but before it is bound to its corresponding SiteMapNode, the InitializeItem method is called. Il InitializeItem metodo applica tutti i modelli o gli stili definiti per un determinato tipo di nodo e crea e inizializza tutti i SiteMapNodeItem controlli figlio contenuti in.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. Infine, il InitializeItem metodo aggiunge i controlli figlio dell'oggetto SiteMapNodeItem alla Controls raccolta.Finally, the InitializeItem method adds the child controls of the SiteMapNodeItem to the Controls collection.

Dopo l' SiteMapNodeItem inizializzazione di ogni OnItemCreated , viene chiamato il metodo.After each SiteMapNodeItem is initialized, the OnItemCreated method is called. Viene quindi associato al corrispondente SiteMapNodee OnDataBound viene chiamato. SiteMapNodeItemThen the SiteMapNodeItem is bound to its corresponding SiteMapNode, and OnDataBound is called.

Il CreateControlHierarchy metodo viene chiamato CreateChildControls dal metodo.The CreateControlHierarchy method is called from the CreateChildControls method.

Le classi che SiteMapPath estendono il controllo eseguono l'override del CreateControlHierarchy metodo SiteMapNodeItem per modificare il modo in cui i SiteMapPath controlli vengono creati o aggiunti al controllo.Classes that extend the SiteMapPath control override the CreateControlHierarchy method to alter how the SiteMapNodeItem controls are created or added to the SiteMapPath control. La manipolazione di singoli elementi del nodo viene eseguita nel InitializeItem metodo e la maggior parte delle classi SiteMapPath che estendono esegue l'override solo del metodo.The manipulation of individual node items is performed in the InitializeItem method, and most classes that extend SiteMapPath override that method only.

Si applica a

Vedi anche