SiteMapNodeCollection クラス

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

SiteMapNodeCollection クラス

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

SiteMapNode オブジェクトの厳密に型指定されたコレクションを提供し、コレクションのナビゲーションをサポートするための IHierarchicalEnumerable インターフェイスを実装します。

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

Visual Basic (宣言)

Public Class SiteMapNodeCollection
    Implements IHierarchicalEnumerable, IList, ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As SiteMapNodeCollection

C#

public class SiteMapNodeCollection : IHierarchicalEnumerable,
 IList, ICollection, 
    IEnumerable

C++

public ref class SiteMapNodeCollection : IHierarchicalEnumerable,
 IList, ICollection, 
    IEnumerable

J#

public class SiteMapNodeCollection implements
 IHierarchicalEnumerable, IList, 
    ICollection, IEnumerable

JScript

public class SiteMapNodeCollection implements
 IHierarchicalEnumerable, IList, 
    ICollection, IEnumerable

解説

SiteMapNodeCollection クラスは、SiteMapNode オブジェクトの厳密に型指定されたコレクションを提供します。また、SiteMapNode オブジェクトをインデックス番号が 0 から始まる配列に内部的に格納します。

SiteMapNodeCollection コレクションは、最初に作成するときに変更できます。その後、次のメソッドを使用して SiteMapNode オブジェクトの追加、コピー、および削除ができます。

• SiteMapNode オブジェクトを追加するには、Add、AddRange、Insert の各メソッドを使用します。

• SiteMapNode オブジェクトをコピーするには、CopyTo メソッドを使用します。

• SiteMapNode オブジェクトを削除するには、Remove メソッドを使用します。

読み取り専用の SiteMapNodeCollection を作成できます。これに対する SiteMapNode オブジェクトの追加、コピー、または削除はできません。作成には、静的な ReadOnly メソッドを使用します。メソッド SiteMapNode.GetAllNodes および GetChildren によって返される SiteMapNodeCollection コレクションは、読み取り専用です。プロバイダから返された SiteMapNode オブジェクト上で ChildNodes プロパティがアクセスされたときに返される SiteMapNodeCollection も同様です。既定のインデクサ プロパティを設定するか、次のメソッドのどれかを使用して、読み取り専用の SiteMapNodeCollection を変更しようとすると、NotSupportedException 例外がスローされます。

• Add

• AddRange

• Clear

• Insert

• Remove

• RemoveAt

上記にリストされているメソッドのどれかを呼び出す前に、IsReadOnly プロパティを使用してコレクションを確認してください。

使用例

SiteMapNodeCollection コレクションを作成し、AddRange メソッドを使用して、それに SiteMapNode オブジェクトを追加する方法を次のコード例に示します。SiteMapNodeCollection は、現在のサイト マップのサブセットで、上位 2 階層レベルのみ表示します。

Visual Basic

' Create a SiteMapNodeCollection with all the nodes
' from the first two hierarchical levels of the current
' site map.
Dim baseCollection As SiteMapNodeCollection
baseCollection = New SiteMapNodeCollection(SiteMap.RootNode)

Dim childCollection As SiteMapNodeCollection
 = SiteMap.RootNode.ChildNodes

baseCollection.AddRange(childCollection)

Response.Write( "<BR>Derived SiteMapNodeCollection.<BR><HR><BR>")

For Each node In baseCollection
    Response.Write( node.Title + "<BR>")
Next

C#

// Create a SiteMapNodeCollection with all the nodes
// from the first two hierarchical levels of the current
// site map.
SiteMapNodeCollection baseCollection =
    new SiteMapNodeCollection(SiteMap.RootNode);

SiteMapNodeCollection childCollection =
    SiteMap.RootNode.ChildNodes;

baseCollection.AddRange(childCollection);

Response.Write( "<BR>Derived SiteMapNodeCollection.<BR><HR><BR>");
foreach (SiteMapNode node in baseCollection)
 {
    Response.Write( node.Title + "<BR>");
}

.NET Framework のセキュリティ

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

継承階層

System.Object
  System.Web.SiteMapNodeCollection

スレッド セーフ

この型の 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

参照

関連項目
SiteMapNodeCollection メンバ
System.Web 名前空間
SiteMap クラス
SiteMapNode クラス
SiteMapProvider
IHierarchyData
その他の技術情報
ASP.NET サイト ナビゲーションの概要
ASP.NET サイト マップ