SiteMapPath.CreateControlHierarchy Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitProtected Overridable Sub CreateControlHierarchy ()Exceptions
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 soit RootNode 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 contient.SiteMapNodeItem 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.
