SiteMapProviderCollection

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

SiteMapProviderCollection クラス

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

サイト マップの初期化中に SiteMap で使用できる SiteMapProvider オブジェクト セットを追跡するため、SiteMap クラスにより使用されます。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 SiteMapProviderCollection
    Inherits ProviderCollection

Visual Basic (使用法)

Dim instance As SiteMapProviderCollection

C#

public sealed class SiteMapProviderCollection
 : ProviderCollection

C++

public ref class SiteMapProviderCollection
 sealed : public ProviderCollection

J#

public final class SiteMapProviderCollection
 extends ProviderCollection

JScript

public final class SiteMapProviderCollection
 extends ProviderCollection

解説

SiteMapProviderCollection クラスは、SiteMapProvider オブジェクトの厳密に型指定された Hashtable コレクションです。2 つの追加メソッド Add(ProviderBase) と Add(SiteMapProvider) の他に、SiteMapProviderCollection クラスは SiteMapProvider 型の配列を追加する AddArray メソッドをサポートします。

SiteMapProviderCollection は、サイト マップの初期化中に SiteMap で使用できる SiteMapProvider オブジェクト セットを追跡するため、SiteMap クラスにより使用されます。ただし、プロバイダ コレクションに SiteMapProvider が存在していても、それが必ず SiteMap オブジェクトによって使用されているわけではなく、使用可能であるというだけです。

SiteMapProvider が SiteMapProviderCollection に格納される場合、Name プロパティがキーとして使用されます。

使用例

SiteMapProviderCollection オブジェクトを SiteMap オブジェクトから取得して、それを反復処理する方法のコード例を次に示します。

サイトに構成されているプロバイダが既定のプロバイダだけではない場合、各プロバイダが表示されます。たとえば、SiteMapProvider クラス概要にあるサンプル AccessSiteMapProvider を使用している場合、次の出力が表示されます。

XmlSiteMapProvider   System.Web.XmlSiteMapProvider
AccessSiteMapProvider   Samples.AspNet.Controls.AccessSiteMapProvider

Visual Basic

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<SCRIPT runat="server">
Private Sub Page_Load(Sender As
 Object, E As EventArgs)

    ' Navigate the SiteMap built by the default SiteMapProvider.
    Response.Write(SiteMap.RootNode.ToString() & "<BR>")

    Response.Write(SiteMap.RootNode.Url & "<BR>")
    Response.Write(SiteMap.RootNode.Title & "<BR>")

    Dim sitemapnode As SiteMapNode
    For Each sitemapnode In
 SiteMap.RootNode.ChildNodes
        ' Iterate through the ChildNodes SiteMapNodesCollection
        ' maintained by the RootNode.
        Response.Write(sitemapnode.Url & "<BR>"
 )
    Next

    Dim providers As IDictionaryEnumerator
 = SiteMap.Providers.GetEnumerator()
    While (providers.MoveNext())
        Response.Write(providers.Current)
        Response.Write("&nbsp;&nbsp;&nbsp;")
        Response.Write("<BR>")
    End While
End Sub ' Page_Load

</SCRIPT>

C#

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<SCRIPT runat="server">
private void Page_Load(object sender, System.EventArgs
 e)
{
    // Navigate the SiteMap built by the default SiteMapProvider.
    Response.Write(SiteMap.RootNode.ToString() + "<BR>");

    Response.Write(SiteMap.RootNode.Url + "<BR>");
    Response.Write(SiteMap.RootNode.Title + "<BR>");

    foreach (SiteMapNode sitemapnode in SiteMap.RootNode.ChildNodes)
    {
        // Iterate through the ChildNodes SiteMapNodesCollection
        // maintained by the RootNode.
        Response.Write(sitemapnode.Url + "<BR>" );
    }

    IEnumerator providers = SiteMap.Providers.GetEnumerator();
    while (providers.MoveNext())
    {
        Response.Write(providers.Current);
        Response.Write("&nbsp;&nbsp;&nbsp;");
        Response.Write("<BR>");
    }
}
</SCRIPT>

.NET Framework のセキュリティ

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

継承階層

System.Object
   System.Configuration.Provider.ProviderCollection
    System.Web.SiteMapProviderCollection

スレッド セーフ

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

参照

関連項目
SiteMapProviderCollection メンバ
System.Web 名前空間
Hashtable
SiteMap.Providers プロパティ
その他の技術情報
ASP.NET サイト ナビゲーション プロバイダ

SiteMapProviderCollection コンストラクタ

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

SiteMapProviderCollection クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SiteMapProviderCollection

C#

public SiteMapProviderCollection ()

C++

public:
SiteMapProviderCollection ()

J#

public SiteMapProviderCollection ()

JScript

public function SiteMapProviderCollection ()

解説

SiteMapProviderCollection の既定のコンストラクタは、フィールドを既定値に初期化します。

プラットフォーム

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

参照

関連項目
SiteMapProviderCollection クラス
SiteMapProviderCollection メンバ
System.Web 名前空間
Add

SiteMapProviderCollection プロパティ

パブリック プロパティ

	名前	説明
	Count	コレクション内のプロバイダの数を取得します。 ( ProviderCollection から継承されます。)
	IsSynchronized	コレクションへのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。 ( ProviderCollection から継承されます。)
	Item	指定した名前の SiteMapProvider オブジェクトをプロバイダ コレクションから取得します。
	SyncRoot	現在のオブジェクトを取得します。 ( ProviderCollection から継承されます。)

参照

関連項目

SiteMapProviderCollection クラス
System.Web 名前空間
Hashtable
SiteMap.Providers プロパティ

その他の技術情報

ASP.NET サイト ナビゲーション プロバイダ

SiteMapProviderCollection メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	オーバーロードされます。 オーバーライドされます。 サイト マップ プロバイダを SiteMapProviderCollection コレクションに追加します。
	AddArray	Name プロパティをキーとして使用して、SiteMapProvider オブジェクトの配列をプロバイダ コレクションに追加します。
	Clear	コレクションからすべての項目を削除します。 ( ProviderCollection から継承されます。)
	CopyTo	指定したインデックスを開始位置として、特定の配列にコレクションの内容をコピーします。 ( ProviderCollection から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	コレクションを反復処理するための IEnumerator インターフェイスを実装するオブジェクトを返します。 ( ProviderCollection から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	コレクションからプロバイダを削除します。 ( ProviderCollection から継承されます。)
	SetReadOnly	コレクションを読み取り専用に設定します。 ( ProviderCollection から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

SiteMapProviderCollection クラス
System.Web 名前空間
Hashtable
SiteMap.Providers プロパティ

その他の技術情報

ASP.NET サイト ナビゲーション プロバイダ

SiteMapProviderCollection メンバ

サイト マップの初期化中に SiteMap で使用できる SiteMapProvider オブジェクト セットを追跡するため、SiteMap クラスにより使用されます。このクラスは継承できません。

SiteMapProviderCollection データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	SiteMapProviderCollection	SiteMapProviderCollection クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Count	コレクション内のプロバイダの数を取得します。(ProviderCollection から継承されます。)
	IsSynchronized	コレクションへのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。(ProviderCollection から継承されます。)
	Item	指定した名前の SiteMapProvider オブジェクトをプロバイダ コレクションから取得します。
	SyncRoot	現在のオブジェクトを取得します。(ProviderCollection から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	オーバーロードされます。 オーバーライドされます。 サイト マップ プロバイダを SiteMapProviderCollection コレクションに追加します。
	AddArray	Name プロパティをキーとして使用して、SiteMapProvider オブジェクトの配列をプロバイダ コレクションに追加します。
	Clear	コレクションからすべての項目を削除します。 (ProviderCollection から継承されます。)
	CopyTo	指定したインデックスを開始位置として、特定の配列にコレクションの内容をコピーします。 (ProviderCollection から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	コレクションを反復処理するための IEnumerator インターフェイスを実装するオブジェクトを返します。 (ProviderCollection から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	コレクションからプロバイダを削除します。 (ProviderCollection から継承されます。)
	SetReadOnly	コレクションを読み取り専用に設定します。 (ProviderCollection から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

SiteMapProviderCollection クラス
System.Web 名前空間
Hashtable
SiteMap.Providers プロパティ

その他の技術情報

ASP.NET サイト ナビゲーション プロバイダ