SiteMapPath.CreateControlHierarchy Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Prozkoumá strukturu mapy webu poskytovanou nástrojem SiteMapProvider a vytvoří kolekci podřízených ovládacích prvků na základě stylů a šablon definovaných pro funkční uzly.

protected:
 virtual void CreateControlHierarchy();
protected virtual void CreateControlHierarchy ();
abstract member CreateControlHierarchy : unit -> unit
override this.CreateControlHierarchy : unit -> unit
Protected Overridable Sub CreateControlHierarchy ()

Výjimky

HttpException

Ovládací SiteMapProvider prvek SiteMapPath nemá k dispozici žádné.

Poznámky

Metoda CreateControlHierarchy vytvoří SiteMapNodeItem ovládací prvky, přidruží je k odpovídajícím SiteMapNode objektům od aktuálního zprostředkovatele mapy webu a přidá uzly do Controls kolekce.

Metoda začíná vyhledáním objektu SiteMap.CurrentNodea poté provede hierarchický strom SiteMapNode objektů a vytvoří SiteMapNodeItem pro každou z nich objekt, dokud RootNode se nedosáhne. Po vytvoření každého SiteMapNodeItem z nich, ale před tím, než je svázán s odpovídající SiteMapNodemetodou InitializeItem , je volána metoda. Metoda InitializeItem použije všechny šablony nebo styly definované pro konkrétní typ uzlu a vytvoří a inicializuje všechny podřízené ovládací prvky, které SiteMapNodeItem obsahuje. InitializeItem Nakonec metoda přidá podřízené SiteMapNodeItem ovládací prvky do Controls kolekce.

Po inicializaci OnItemCreated každé z těchto SiteMapNodeItem metod je volána metoda. Potom je vázán SiteMapNodeItem na odpovídající SiteMapNodea OnDataBound je volána.

Metoda CreateControlHierarchy je volána z CreateChildControls metody.

Třídy, které rozšiřují SiteMapPath ovládací prvek, přepíší metodu CreateControlHierarchy , aby změnila způsob SiteMapNodeItem vytváření nebo přidání ovládacích prvků do SiteMapPath ovládacího prvku. Manipulace s jednotlivými položkami uzlu se provádí v InitializeItem metodě a většina tříd, které rozšiřují SiteMapPath , přepíše pouze tuto metodu.

Platí pro

Viz také