SiteMapPath.CreateControlHierarchy Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Examina la estructura del mapa del sitio proporcionada por SiteMapProvider y genera una colección de controles secundarios basada en los estilos y plantillas definidos para los nodos funcionales.
protected:
virtual void CreateControlHierarchy();
protected virtual void CreateControlHierarchy ();
abstract member CreateControlHierarchy : unit -> unit
override this.CreateControlHierarchy : unit -> unit
Protected Overridable Sub CreateControlHierarchy ()
Excepciones
No hay ninguna SiteMapProvider disponible para el control SiteMapPath.
Comentarios
El CreateControlHierarchy método crea SiteMapNodeItem controles, los asocia con los objetos correspondientes SiteMapNode del proveedor de mapa de sitio actual y agrega los nodos a la Controls colección.
El método comienza buscando SiteMap.CurrentNodey, a continuación, recorre el árbol jerárquico de SiteMapNode objetos, creando un SiteMapNodeItem para cada uno hasta RootNode que se alcanza . Después de crear cada una SiteMapNodeItem de ellas, pero antes de enlazarla a su correspondiente SiteMapNode, se llama al InitializeItem método . El InitializeItem método aplica cualquier plantilla o estilos definidos para un tipo de nodo determinado y crea e inicializa los controles secundarios que SiteMapNodeItem contiene. Por último, el InitializeItem método agrega los controles secundarios de SiteMapNodeItem a la Controls colección .
Después de inicializar cada SiteMapNodeItem uno, se llama al OnItemCreated método . SiteMapNodeItem A continuación, se enlaza a su correspondiente SiteMapNodey OnDataBound se llama a .
Se CreateControlHierarchy llama al método desde el CreateChildControls método .
Las clases que extienden el SiteMapPath control invalidan el CreateControlHierarchy método para modificar cómo se crean o agregan los SiteMapNodeItem controles al SiteMapPath control. La manipulación de elementos de nodo individuales se realiza en el InitializeItem método y la mayoría de las clases que extienden SiteMapPath solo invalidan ese método.