SiteMapPath.InitializeItem(SiteMapNodeItem) Método

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Preenche uma SiteMapNodeItem, que é um controle de servidor Web que representa um SiteMapNode, com um conjunto de controles filho baseados na função do nó e nos modelos e estilos especificados para o nó.

protected:
 virtual void InitializeItem(System::Web::UI::WebControls::SiteMapNodeItem ^ item);

protected virtual void InitializeItem (System.Web.UI.WebControls.SiteMapNodeItem item);

abstract member InitializeItem : System.Web.UI.WebControls.SiteMapNodeItem -> unit
override this.InitializeItem : System.Web.UI.WebControls.SiteMapNodeItem -> unit

Protected Overridable Sub InitializeItem (item As SiteMapNodeItem)

Parâmetros

item

SiteMapNodeItem

O SiteMapNodeItem a ser inicializado.

Exemplos

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

// 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);
    }
}

' Override the InitializeItem method to add a PathSeparator
' and DropDownList to the current node.
Protected Overrides Sub InitializeItem(item As SiteMapNodeItem)

   ' The only node that must be handled is the CurrentNode.
   If item.ItemType = SiteMapNodeItemType.Current Then
      Dim hLink As New HyperLink()

      ' No Theming for the HyperLink.
      hLink.EnableTheming = False
      ' Enable the link of the SiteMapPath is enabled.
      hLink.Enabled = Me.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 Then
         hLink.ToolTip = item.SiteMapNode.Description
      End If

      ' Apply styles or templates to the HyperLink here.
      ' ...
      ' ...
      ' Add the item to the Controls collection.
      item.Controls.Add(hLink)

      AddDropDownListAfterCurrentNode(item)
   Else
      MyBase.InitializeItem(item)
   End If
End Sub

Comentários

O InitializeItem método determina o tipo funcional de nó que o item representa verificando o e aplica todos os SiteMapNodeItemTypemodelos ou estilos definidos para esse tipo de nó.

Se o SiteMapNodeItem tiver um Root tipo de item, um HyperLink controle filho será criado e o RootNodeTemplate e RootNodeStyle poderão ser aplicados. Se o RootNodeTemplate estiver definido, ele ITemplate será aplicado ao nó. Em vez disso, o RootNodeStyle é definido, ele é mesclado com qualquer definido NodeStyle e aplicado. Por fim, se nenhum modelo ou estilo for definido, um controle básico HyperLink será criado e inicializado com valores do nó.

Se o SiteMapNodeItem tiver um Current tipo de item, um Literal controle filho ou HyperLink será criado, dependendo do valor retornado de RenderCurrentNodeAsLink. Em seguida, o CurrentNodeTemplate ou CurrentNodeStyle pode ser aplicado. Se o CurrentNodeTemplate estiver definido, ele ITemplate será aplicado ao nó. Se, em vez disso, o CurrentNodeStyle estiver definido, ele será mesclado com qualquer definido NodeStyle e aplicado.

Se o SiteMapNodeItem tiver um Parent tipo de item, um HyperLink controle filho será criado e o NodeTemplate e NodeStyle poderá ser aplicado. Se o NodeTemplate estiver definido, ele ITemplate será aplicado ao nó. Se, em vez disso, o NodeStyle estiver definido, ele será aplicado.

Por fim, se o SiteMapNodeItem tiver um PathSeparator tipo de item, um Literal controle filho será criado e o PathSeparatorTemplate e PathSeparatorStyle serão aplicados de acordo com as mesmas regras gerais definidas para um Parent tipo de nó.

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

Confira também

• CreateControlHierarchy()
• Controle de servidor Web SiteMapPath