SiteMapPath.InitializeItem(SiteMapNodeItem) メソッド

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.dll

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子コントロールが作成され、 と RootNodeStyle がRootNodeTemplate適用される場合があります。 が RootNodeTemplate 設定されている場合、その ITemplate がノードに適用されます。 代わりに、 RootNodeStyle が設定され、定義 NodeStyle された とマージされて適用されます。 最後に、テンプレートまたはスタイルが定義されていない場合は、基本的な HyperLink コントロールが作成され、ノードの値で初期化されます。

SiteMapNodeItemに項目の種類があるCurrent場合は、 Literal の戻り値RenderCurrentNodeAsLinkに応じて、 または HyperLink 子コントロールが作成されます。 次に、 または CurrentNodeStyle をCurrentNodeTemplate適用できます。 が CurrentNodeTemplate 設定されている場合、その ITemplate がノードに適用されます。 代わりに が CurrentNodeStyle 設定されている場合は、定義 NodeStyle された とマージされ、適用されます。

SiteMapNodeItemに項目の種類があるParent場合は、HyperLink子コントロールが作成され、 と NodeStyle がNodeTemplate適用される場合があります。 が NodeTemplate 設定されている場合、その ITemplate がノードに適用されます。 代わりに が NodeStyle 設定されている場合は、適用されます。

最後に、 に SiteMapNodeItem 項目の種類がある PathSeparator 場合は、 Literal 子コントロールが作成され、 PathSeparatorTemplate と がノードの種類に対して定義されているのと PathSeparatorStyle 同じ一般的な規則に Parent 従って適用されます。

メソッドを InitializeItem オーバーライドして、個々 SiteMapNodeItem のオブジェクトを操作します。 クラスの設計で、オブジェクトの作成方法とコントロールへの追加方法 SiteMapNodeItem をより詳細に制御する SiteMapPath 必要がある場合は、 メソッドをオーバーライドします CreateControlHierarchy 。

こちらもご覧ください

• CreateControlHierarchy()
• SiteMapPath Web サーバー コントロール