SiteMap.Provider プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SiteMap.Provider プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在のサイトマップの既定の SiteMapProvider オブジェクトを取得します。

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

Visual Basic (宣言)

Public Shared ReadOnly Property
 Provider As SiteMapProvider

Visual Basic (使用法)

Dim value As SiteMapProvider

value = SiteMap.Provider

public static SiteMapProvider Provider { get;
 }

C++

public:
static property SiteMapProvider^ Provider {
    SiteMapProvider^ get ();
}

/** @property */
public static SiteMapProvider get_Provider
 ()

JScript

public static function get
 Provider () : SiteMapProvider

プロパティ値
SiteMap の既定のサイトマッププロバイダ。

例外

例外の種類	条件
InvalidOperationException	このサイトマップ機能は無効になっています。
ConfigurationErrorsException	構成に指定されている既定のプロバイダが存在しません。
HttpException	この機能は、信頼性が低以上の場合にのみサポートされます。

解説

既定では、XmlSiteMapProvider オブジェクトが使用され、サイトのルートディレクトリにある Web.sitemap ファイルからサイトナビゲーションデータが読み込まれます。これは、サイトナビゲーション構成を管理する管理クラスと Web.config ファイルのサイトマップ構成セクションで指定されます。既定では、これは XmlSiteMapProvider クラスのインスタンスで、Web.sitemap ファイルを永続記憶領域として使用します。ただし、SiteMapProvider 抽象クラスを実装するクラスを記述することにより、独自のサイトマップストレージと構成スキームを実装できます。独自のプロバイダの記述の詳細については、「SiteMapProvider」を参照してください。

使用例

サイトの既定の SiteMapProvider オブジェクトに静的プロパティ Provider を使用してアクセスする方法のコード例を次に示します。

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>

<%@ 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>

プラットフォーム

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

参照

関連項目
SiteMap クラス
SiteMap メンバ
System.Web 名前空間
Providers
SiteMapProvider
StaticSiteMapProvider

SiteMapProvider プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	CurrentNode	現在要求されているページを表す SiteMapNode オブジェクトを取得します。
	Description	管理ツールまたは他のユーザーインターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 ( ProviderBase から継承されます。)
	EnableLocalization	SiteMapNode 属性のローカライズされた値が返されるかどうかを示すブール値を取得または設定します。
	Name	構成時にプロバイダを参照するために使用される表示名を取得します。 ( ProviderBase から継承されます。)
	ParentProvider	現在のプロバイダの親 SiteMapProvider オブジェクトを取得または設定します。
	ResourceKey	SiteMapNode 属性のローカライズに使用するリソースキーを取得または設定します。
	RootNode	現在のプロバイダが表すサイトマップデータのルート SiteMapNode オブジェクトを取得します。
	RootProvider	現在のプロバイダ階層のルート SiteMapProvider オブジェクトを取得します。
	SecurityTrimmingEnabled	サイトマッププロバイダがユーザーのロールに基づいてサイトマップノードをフィルタ処理するかどうかを示すブール値を取得します。