SiteMapNodeItem クラス

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

SiteMapNodeItem クラス

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

SiteMapNodeItem クラスは、SiteMapPath コントロールによって使用され、機能的に SiteMapNode を表します。

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

Visual Basic (宣言)

Public Class SiteMapNodeItem
    Inherits WebControl
    Implements IDataItemContainer, INamingContainer

Visual Basic (使用法)

Dim instance As SiteMapNodeItem

C#

public class SiteMapNodeItem : WebControl,
 IDataItemContainer, INamingContainer

C++

public ref class SiteMapNodeItem : public
 WebControl, IDataItemContainer, INamingContainer

J#

public class SiteMapNodeItem extends WebControl
 implements IDataItemContainer, INamingContainer

JScript

public class SiteMapNodeItem extends
 WebControl implements IDataItemContainer, INamingContainer

解説

SiteMapPath コントロールは CompositeControl です。つまり、このコントロールは、数多くの他の Web サーバー コントロールで構成されるユーザー インターフェイスを表示します。SiteMapPath コントロールは、サイト用に構成された SiteMap とその SiteMapNode オブジェクトと直接連携して機能しますが、SiteMapNode オブジェクトは Web サーバー コントロールではありません。SiteMapNodeItem クラスは、SiteMapNode クラスに対する Web サーバー コントロール ラッパーです。これにより、一般的なナビゲーション データ アイテムとユーザー インターフェイス アイテムとの機能的な違いを維持しながら、SiteMapPath コントロールで SiteMapNode のデータを表示できます。

SiteMapPath コントロールは、その Controls コレクションでサイト マップの各ノードを内部的に保持します。SiteMapPath は、その子コントロールを種々のスタイル、テンプレート、および順序で表示できるため、表示の順序とは関係なく、機能的に異なる型のノードを区別できます。こうした理由から、それぞれの SiteMapNodeItem は特定の型を使用して作成されます (指定できる型は、SiteMapNodeItemType 列挙体に記載されています)。

SiteMapNodeItem クラスをコード内で直接使用するのは、SiteMapPath コントロールを拡張する計画や、類似の機能を持つコントロールを記述する計画がある場合だけにしてください。

使用例

SiteMapPath から派生したクラスの InitializeItem メソッド内で SiteMapNodeItem オブジェクトの作成および操作を行う方法を次のコード例に示します。このコード例は、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

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.SiteMapNodeItem

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

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