SiteMapPath.CreateControlHierarchy Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Examina a estrutura de mapa do site fornecida pelo SiteMapProvider e cria uma coleção de controles filho baseada nos estilos e modelos definidos para os nós funcionais.

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

Exceções

HttpException

Nenhum SiteMapProvider está disponível para o controle SiteMapPath.

Comentários

O CreateControlHierarchy método cria SiteMapNodeItem controles, os associa aos objetos correspondentes SiteMapNode do provedor de mapa do site atual e adiciona os nós à Controls coleção.

O método começa localizando o SiteMap.CurrentNodee, em seguida, percorre a árvore hierárquica de SiteMapNode objetos, criando um para cada um SiteMapNodeItem até que o RootNode seja atingido. Depois que cada SiteMapNodeItem um é criado, mas antes de ser associado ao respectivo , SiteMapNodeo InitializeItem método é chamado. O InitializeItem método aplica todos os modelos ou estilos definidos para um tipo de nó específico e cria e inicializa todos os controles filho que o SiteMapNodeItem contém. Por fim, o InitializeItem método adiciona os controles filho do SiteMapNodeItem à Controls coleção.

Depois que cada SiteMapNodeItem um é inicializado, o OnItemCreated método é chamado. Em seguida, o SiteMapNodeItem é associado a seu correspondente SiteMapNodee OnDataBound é chamado.

O CreateControlHierarchy método é chamado do CreateChildControls método .

Classes que estendem o SiteMapPath controle substituem o CreateControlHierarchy método para alterar como os SiteMapNodeItem controles são criados ou adicionados ao SiteMapPath controle. A manipulação de itens de nó individuais é executada no método e a InitializeItem maioria das classes que estendem SiteMapPath a substituição apenas desse método.

Aplica-se a

Confira também