SiteMap.Providers プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SiteMapProvider クラスで使用可能な名前付き SiteMap オブジェクトの読み取り専用コレクションを取得します。
public:
static property System::Web::SiteMapProviderCollection ^ Providers { System::Web::SiteMapProviderCollection ^ get(); };public static System.Web.SiteMapProviderCollection Providers { get; }static member Providers : System.Web.SiteMapProviderCollectionPublic Shared ReadOnly Property Providers As SiteMapProviderCollectionプロパティ値
名前付き SiteMapProviderCollection オブジェクトの SiteMapProvider。
例外
このサイト マップ機能は無効になっています。
構成に指定されている既定のプロバイダーが存在しません。
この機能は、信頼性が低以上の場合にのみサポートされます。
例
次のコード例では、 クラスからSiteMapコレクションをProviders取得し、それを反復処理する方法を示します。
<%@ 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(" ");
Response.Write("<BR>");
}
}
</SCRIPT>
<%@ 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(" ")
Response.Write("<BR>")
End While
End Sub ' Page_Load
</SCRIPT>
サイトに対して構成されている既定のプロバイダー以外のプロバイダーがある場合は、各プロバイダーが表示されます。 たとえば、サンプル Microsoft Access プロバイダー (を参照StaticSiteMapProvider) を使用している場合、次の出力が表示されます。
XmlSiteMapProvider System.Web.XmlSiteMapProvider
AccessSiteMapProvider Samples.AspNet.AccessSiteMapProvider
注釈
コレクションに一覧表示されるサイト マップ プロバイダーは、クラスを Providers 初期化 SiteMap するために構成階層で指定されているプロバイダーです。 既定のプロバイダー (プロパティで Provider 識別される) のみが、初期化時に によって SiteMap 使用されることを保証します。コレクション内 Providers にプロバイダーが存在することは、それが構成で指定され、初期化中に使用可能であることを意味します。
