SiteMapPath.InitializeItem(SiteMapNodeItem) 方法

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.dll

根据节点功能和为节点指定的模板和样式，使用一组子控件填充 SiteMapNodeItem，这是一个表示 SiteMapNode 的 Web 服务器控件。

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确定项所表示的节点的功能类型，并应用为该类型节点定义的任何模板或样式。

如果 具有Root项类型，则创建一个HyperLink子控件，并RootNodeTemplate可以应用 和 RootNodeStyle 。SiteMapNodeItem RootNodeTemplate如果设置了 ，则将其ITemplate应用于节点。 相反， RootNodeStyle 设置为 ，它与任何定义 NodeStyle 和应用合并。 最后，如果未定义任何模板或样式，则会创建一个基本 HyperLink 控件，并使用节点中的值进行初始化。

SiteMapNodeItem如果 具有Current项类型，Literal则会创建 或 HyperLink 子控件，具体取决于 的RenderCurrentNodeAsLink返回值。 然后， CurrentNodeTemplate 可以应用 或 CurrentNodeStyle 。 CurrentNodeTemplate如果设置了 ，则将其ITemplate应用于节点。 如果改为 CurrentNodeStyle 设置 ，则会将其与任何定义 NodeStyle 和应用合并。

SiteMapNodeItem如果 具有Parent项类型，则会创建一个HyperLink子控件，并NodeTemplate可以应用 和 NodeStyle 。 NodeTemplate如果设置了 ，则将其ITemplate应用于节点。 如果改为 NodeStyle 设置 ，则应用它。

最后，如果 SiteMapNodeItem 具有PathSeparator项类型，则会创建一个Literal子控件，PathSeparatorTemplate并根据为Parent节点类型定义的相同常规规则应用 和 PathSeparatorStyle 。

InitializeItem重写 方法以操作单个SiteMapNodeItem对象。 如果 类的设计需要对对象的创建和添加到SiteMapPath控件的方式SiteMapNodeItem进行更广泛的控制，请重写 CreateControlHierarchy 方法。

另请参阅

• CreateControlHierarchy()
• SiteMapPath Web 服务器控件