SiteMapPath.CreateControlHierarchy Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

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

HttpException

No hay ninguna SiteMapProvider disponible para el control SiteMapPath.

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 buscando y SiteMap.CurrentNode, 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 SiteMapNodeItem de ellos, pero antes de enlazarse 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 SiteMapNodeItem a 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 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.

Se aplica a

Consulte también