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 指定，而且可在初始化期間使用。
