SiteMapPath.CreateControlHierarchy Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.