SiteMapPath.CreateControlHierarchy Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Examine la structure du plan de site fournie par le SiteMapProvider et construit une collection de contrôles enfants basée sur les styles et les modèles définis pour les nœuds fonctionnels.

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

Exceptions

HttpException

Aucun SiteMapProvider n'est disponible pour le contrôle SiteMapPath.

Remarques

La CreateControlHierarchy méthode crée SiteMapNodeItem des contrôles, les associe aux objets correspondants SiteMapNode du fournisseur de plan de site actuel et ajoute les nœuds à la Controls collection.

La méthode commence par trouver le SiteMap.CurrentNode, puis parcourt l’arborescence hiérarchique des SiteMapNode objets, en créant un SiteMapNodeItem pour chacun d’eux jusqu’à ce que le RootNode soit atteint. Une fois que chaque SiteMapNodeItem est créé, mais avant qu’il ne soit lié à son correspondant SiteMapNode, la InitializeItem méthode est appelée. La InitializeItem méthode applique tous les modèles ou styles définis pour un type de nœud particulier et crée et initialise tous les contrôles enfants que le SiteMapNodeItem contient. Enfin, la InitializeItem méthode ajoute les contrôles enfants du SiteMapNodeItem à la Controls collection.

Une fois que chaque SiteMapNodeItem est initialisé, la OnItemCreated méthode est appelée. Ensuite, est SiteMapNodeItem lié à son correspondant SiteMapNode, et OnDataBound est appelé.

La CreateControlHierarchy méthode est appelée à partir de la CreateChildControls méthode .

Les classes qui étendent le SiteMapPath contrôle remplacent la CreateControlHierarchy méthode pour modifier la façon dont les SiteMapNodeItem contrôles sont créés ou ajoutés au SiteMapPath contrôle. La manipulation d’éléments de nœud individuels est effectuée dans la méthode , et la InitializeItem plupart des classes qui étendent SiteMapPath remplacent cette méthode uniquement.

S’applique à

Voir aussi