Compartir a través de

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 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.

Se aplica a

Consulte también