Método SiteMapPath.InitializeItem

O InitializeItem método determina o tipo funcional do nó representando o item, marcando o SiteMapNodeItemTypee aplica quaisquer modelos ou estilos que são definidos para aquele tipo de nó.

Se a SiteMapNodeItem tem um Root item type, um HyperLink controle filho é criado e o RootNodeTemplate e RootNodeStyle podem ser aplicadas. Se a RootNodeTemplate for definida, seu ITemplate é aplicado ao nó. Em vez disso, o RootNodeStyle estiver definida, ela é mesclada com qualquer definição NodeStyle e aplicadas. Finalmente, se não há modelos ou estilos definidos, um basic HyperLink controle é criado e inicializado com valores a partir do nó.

Se a SiteMapNodeItem tem um Current item type, ou um Literal ou HyperLink controle filho é criado, dependendo do valor de retorno de RenderCurrentNodeAsLink. E ambos os CurrentNodeTemplate ou CurrentNodeStyle podem ser aplicadas. Se a CurrentNodeTemplate for definida, seu ITemplate é aplicado ao nó. Se, em vez disso, o CurrentNodeStyle estiver definida, ela é mesclada com qualquer definição NodeStyle e aplicadas.

Se a SiteMapNodeItem tem um Parent item type, um HyperLink controle filho é criado e o NodeTemplate e NodeStyle podem ser aplicadas. Se a NodeTemplate for definida, seu ITemplate é aplicado ao nó. Se, em vez disso, o NodeStyle estiver definida, ela é aplicada.

Finalmente, se a SiteMapNodeItem tem um PathSeparator item type, um Literal controle filho é criado e o PathSeparatorTemplate e PathSeparatorStyle são aplicadas de acordo com as mesmas regras gerais definidas para um Parent tipo de nó.

Substituir o InitializeItem método para manipular individuais SiteMapNodeItem objetos. Se o design da classe requer um controle mais abrangente sobre como o SiteMapNodeItem os objetos são criados e adicionados ao SiteMapPath controlar, substituir o CreateControlHierarchy método.

O exemplo de código a seguir demonstra como substituir o InitializeItem método para adicionar funcionalidade a um controle que deriva de SiteMapPath. Este exemplo de código é parte de um exemplo maior fornecido para a classe SiteMapPath.

// Override the InitializeItem method to add a PathSeparator
// and DropDownList to the current node.
protected override void InitializeItem(SiteMapNodeItem item) {

    // The only node that must be handled is the CurrentNode.
    if (item.ItemType == SiteMapNodeItemType.Current)
    {
        HyperLink hLink = new HyperLink();

        // No Theming for the HyperLink.
        hLink.EnableTheming = false;
        // Enable the link of the SiteMapPath is enabled.
        hLink.Enabled = this.Enabled;

        // Set the properties of the HyperLink to
        // match those of the corresponding SiteMapNode.
        hLink.NavigateUrl = item.SiteMapNode.Url;
        hLink.Text        = item.SiteMapNode.Title;
        if (ShowToolTips) {
            hLink.ToolTip = item.SiteMapNode.Description;
        }

        // Apply styles or templates to the HyperLink here.
        // ...
        // ...

        // Add the item to the Controls collection.
        item.Controls.Add(hLink);

        AddDropDownListAfterCurrentNode(item);
    }
    else {
        base.InitializeItem(item);
    }
}

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

Referência

Outros recursos