SiteMapNodeItemType 列挙体

.NET Framework クラス ライブラリ リファレンス

SiteMapNodeItemType 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

SiteMapNodeItemType 列挙体は、ノード階層内の SiteMapNodeItem ノードの種類を識別するために、SiteMapPath コントロールによって使用されます。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Enumeration SiteMapNodeItemType

Visual Basic (使用法)

Dim instance As SiteMapNodeItemType

C#

public enum SiteMapNodeItemType

C++

public enum class SiteMapNodeItemType

J#

public enum SiteMapNodeItemType

JScript

public enum SiteMapNodeItemType

メンバ

	メンバ名	説明
	Current	サイト ナビゲーション パスの現在表示されているページ。
	Parent	サイト ナビゲーション パスの現在表示されているページの親ノード。親ノードとは、ナビゲーション階層内でルート ノードと現在のノードの間に存在するノードです。
	PathSeparator	サイト マップ ナビゲーション パスの区切り記号。SiteMapPath コントロールの既定の区切り記号は、">" 文字です。
	Root	サイト ナビゲーション階層の一番上のノード。ルート ノードは 1 つしか存在しません。

解説

SiteMapPath コントロールは、そのサイト ナビゲーション情報を SiteMapNodeItem オブジェクトのコレクションとして管理します。SiteMapNodeItem オブジェクトは、機能的に異なる種類の SiteMapNode ノードを表します。したがって、それらは SiteMapPath コントロールによって管理されます。利用できるノードの種類は、次のとおりです。

• 現在表示されているページを表す 1 つのノード。

• サイト ナビゲーション階層の一番上のノードである 1 つのノード。

• 一番上のノードと現在のノードの間にある 0 個以上のノード (親ノード)。

• サイト ナビゲーション パスの区切り記号を表す 0 個以上のノード。

PathSeparator の種類のノードを除き、各ノードは基になる SiteMapNode にデータ連結されます。

使用例

InitializeItem メソッド内で、SiteMapNodeItem を作成した後、OnItemCreated メソッドを呼び出す方法を次のコード例に示します。このコード例は、SiteMapPath クラスのトピックで取り上げている、コード例の一部分です。

Visual Basic

Private Sub AddDropDownListAfterCurrentNode(item
 As SiteMapNodeItem)

   Dim childNodes As SiteMapNodeCollection
 = item.SiteMapNode.ChildNodes

   ' Only do this work if there are child nodes.
   If Not (childNodes Is
 Nothing) Then

      ' Add another PathSeparator after the CurrentNode.
      Dim finalSeparator As New
 SiteMapNodeItem(item.ItemIndex, SiteMapNodeItemType.PathSeparator)

      Dim eventArgs As New
 SiteMapNodeItemEventArgs(finalSeparator)

      InitializeItem(finalSeparator)
      ' Call OnItemCreated every time a SiteMapNodeItem is
      ' created and initialized.
      OnItemCreated(eventArgs)

      ' The pathSeparator does not bind to any SiteMapNode, so
      ' do not call DataBind on the SiteMapNodeItem.
      item.Controls.Add(finalSeparator)

      ' Create a DropDownList and populate it with the children of the
      ' CurrentNode. There are no styles or templates that are applied
      ' to the DropDownList control. If OnSelectedIndexChanged is raised
,
      ' the event handler redirects to the page selected.
      ' The CurrentNode has child nodes.
      Dim ddList As New
 DropDownList()
      ddList.AutoPostBack = True

      AddHandler ddList.SelectedIndexChanged, AddressOf
 Me.DropDownNavPathEventHandler

      ' Add a ListItem to the DropDownList for every node in the
      ' SiteMapNodes collection.
      Dim node As SiteMapNode
      For Each node In 
 childNodes
         ddList.Items.Add(New ListItem(node.Title, node.Url))
      Next node

      item.Controls.Add(ddList)
   End If
End Sub 'AddDropDownListAfterCurrentNode

C#

private void AddDropDownListAfterCurrentNode(SiteMapNodeItem
 item) {

    SiteMapNodeCollection childNodes = item.SiteMapNode.ChildNodes;

    // Only do this work if there are child nodes.
    if (childNodes != null) {

        // Add another PathSeparator after the CurrentNode.
        SiteMapNodeItem finalSeparator =
            new SiteMapNodeItem(item.ItemIndex,
                                SiteMapNodeItemType.PathSeparator);

        SiteMapNodeItemEventArgs eventArgs =
            new SiteMapNodeItemEventArgs(finalSeparator);

        InitializeItem(finalSeparator);
        // Call OnItemCreated every time a SiteMapNodeItem is
        // created and initialized.
        OnItemCreated(eventArgs);

        // The pathSeparator does not bind to any SiteMapNode, so
        // do not call DataBind on the SiteMapNodeItem.
        item.Controls.Add(finalSeparator);

        // Create a DropDownList and populate it with the children of
 the
        // CurrentNode. There are no styles or templates that are applied
        // to the DropDownList control. If OnSelectedIndexChanged is
 raised,
        // the event handler redirects to the page selected.
        // The CurrentNode has child nodes.
        DropDownList ddList = new DropDownList();
        ddList.AutoPostBack = true;

        ddList.SelectedIndexChanged += new EventHandler(this.DropDownNavPathEventHandler);

        // Add a ListItem to the DropDownList for every node in the
        // SiteMapNodes collection.
        foreach (SiteMapNode node in childNodes)
 {
            ddList.Items.Add(new ListItem(node.Title, node.Url));
        }

        item.Controls.Add(ddList);
    }
}

J#

private void AddDropDownListAfterCurrentNode(SiteMapNodeItem
 item)
{
    SiteMapNodeCollection childNodes = item.get_SiteMapNode().
        get_ChildNodes();
    // Only do this work if there are child nodes.
    if (childNodes != null) {
        // Add another PathSeparator after the CurrentNode.
        SiteMapNodeItem finalSeparator = new SiteMapNodeItem(item.
            get_ItemIndex(), SiteMapNodeItemType.PathSeparator);

        SiteMapNodeItemEventArgs eventArgs = new SiteMapNodeItemEventArgs(
            finalSeparator);

        InitializeItem(finalSeparator);
        // Call OnItemCreated every time a SiteMapNodeItem is
        // created and initialized.
        OnItemCreated(eventArgs);
        // The pathSeparator does not bind to any SiteMapNode, so 
        // do not call DataBind on the SiteMapNodeItem.
        item.get_Controls().Add(finalSeparator);
        // Create a DropDownList and populate it with the children of
 the 
        // CurrentNode. There are no styles or templates that are applied
        // to the DropDownList control. If OnSelectedIndexChanged is
 raised, 
        // the event handler redirects to the page selected.
        // The CurrentNode has child nodes.
        DropDownList ddList = new DropDownList();
        ddList.set_AutoPostBack(true);

        ddList.add_SelectedIndexChanged(new EventHandler(this.
            DropDownNavPathEventHandler));
        // Add a ListItem to the DropDownList for every node in the
        // SiteMapNodes collection.
        for (int iCtr = 0; iCtr < childNodes.get_Count();
 iCtr++) {
            SiteMapNode node = (SiteMapNode)childNodes.get_Item(iCtr);
            ddList.get_Items().Add(new ListItem(node.get_Title(),
 node.
                get_Url()));
        }

        item.get_Controls().Add(ddList);
    }
} //AddDropDownListAfterCurrentNode

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Web.UI.WebControls 名前空間
SiteMapNodeItem クラス
SiteMapPath
その他の技術情報
ASP.NET サイト ナビゲーション
SiteMapPath Web サーバー コントロールの概要
ASP.NET のサイト ナビゲーションの保護