SiteMapPath.InitializeItem(SiteMapNodeItem) 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

填入 (Populate) 表示 SiteMapNodeItem 之 Web 伺服器控制項的 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根據的RenderCurrentNodeAsLink傳回值建立 或 HyperLink 子控件。 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 伺服器控制件