SiteMapPath.InitializeItem(SiteMapNodeItem) Метод

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.dll

Заполняет SiteMapNodeItem, являющийся элементом управления веб-сервера, представляющим SiteMapNode с набором дочерних элементов управления, основывающихся на функции узла и указанных шаблонах и стилях.

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)

Параметры

item

SiteMapNodeItem

Объект SiteMapNodeItem для инициализации.

Примеры

В следующем примере кода показано, как переопределить InitializeItem метод , чтобы добавить функциональные возможности в элемент управления, производный от SiteMapPath. Этот пример входит в состав более крупного примера использования класса 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);
    }
}

' 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

Комментарии

Метод InitializeItem определяет функциональный тип узла, который представляет элемент, проверив SiteMapNodeItemType, и применяет все шаблоны или стили, определенные для узла этого типа.

SiteMapNodeItem Если имеет Root тип элемента, создается дочерний HyperLink элемент управления, а RootNodeTemplate также могут применяться и RootNodeStyle . RootNodeTemplate Если задан параметр , он ITemplate применяется к узлу. Вместо этого RootNodeStyle задается , он объединяется с любым определенным NodeStyle и примененным. Наконец, если шаблоны или стили не определены, создается и инициализируется базовый HyperLink элемент управления со значениями из узла.

SiteMapNodeItem Если элемент имеет Current тип элемента, создается дочерний Literal элемент управления или HyperLink в зависимости от возвращаемого RenderCurrentNodeAsLinkзначения . Затем можно применить или CurrentNodeTemplateCurrentNodeStyle . CurrentNodeTemplate Если задан параметр , он ITemplate применяется к узлу. Если вместо этого CurrentNodeStyle задан , он объединяется с любыми определенными NodeStyle и применяемыми.

SiteMapNodeItem Если элемент имеет Parent тип элемента, создается дочерний HyperLink элемент управления и NodeTemplate могут применяться и NodeStyle . NodeTemplate Если задан параметр , он ITemplate применяется к узлу. Если вместо этого NodeStyle задано значение , он применяется.

Наконец, если SiteMapNodeItem имеет PathSeparator тип элемента, создается дочерний Literal элемент управления, а PathSeparatorTemplatePathSeparatorStyle и применяются в соответствии с теми же общими правилами, определенными для Parent типа узла.

Переопределите метод для управления отдельными InitializeItemSiteMapNodeItem объектами. Если для проектирования класса требуется более широкий контроль над тем, как SiteMapNodeItem объекты создаются и добавляются в SiteMapPath элемент управления , переопределите CreateControlHierarchy метод .

См. также раздел

• CreateControlHierarchy()
• Серверный веб-элемент управления SiteMapPath