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 de sitio proporcionada por SiteMapProvider y crea una colección de controles secundarios en función de 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 -> unitProtected Overridable Sub CreateControlHierarchy ()Excepciones
No SiteMapProvider está disponible para el SiteMapPath control.
Comentarios
El CreateControlHierarchy método crea SiteMapNodeItem controles, los asocia a los objetos correspondientes SiteMapNode del proveedor de mapa del sitio actual y agrega los nodos a la Controls colección.
El método comienza por buscar 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 uno de ellos SiteMapNodeItem , pero antes de enlazar a su correspondiente SiteMapNode, se llama al InitializeItem método . El InitializeItem método aplica las plantillas 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 a SiteMapNodeItem la Controls colección .
Después de inicializar cada uno SiteMapNodeItem , 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 control invalidan el SiteMapPathCreateControlHierarchy 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 la invalidación solo de ese método.