SiteMap.Providers 屬性

  • 參考

定義

命名空間:
System.Web
組件:
System.Web.dll

取得名稱為 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.SiteMapProviderCollection
Public Shared ReadOnly Property Providers As SiteMapProviderCollection

屬性值

SiteMapProviderCollection

名稱為 SiteMapProviderCollection 物件的 SiteMapProvider。

例外狀況

InvalidOperationException

未啟用網站導覽功能。

ConfigurationErrorsException

組態中指定的預設提供者不存在。

HttpException

只有低度信任 (含) 以上的模式才有支援這個功能。

範例

下列程式碼範例示範如何從 類別擷 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 指定，而且可在初始化期間使用。

適用於

另請參閱