Bagikan melalui

SiteMap.Providers Properti

Definisi

Ruang nama:
System.Web
Rakitan:
System.Web.dll

Mendapatkan kumpulan objek bernama SiteMapProvider baca-saja yang tersedia untuk SiteMap kelas .

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

Nilai Properti

SiteMapProviderCollection

Objek SiteMapProviderCollection bernama SiteMapProvider .

Pengecualian

InvalidOperationException

Fitur peta situs tidak diaktifkan.

ConfigurationErrorsException

Penyedia default yang ditentukan dalam konfigurasi tidak ada.

HttpException

Fitur ini hanya didukung saat berjalan dalam kepercayaan Rendah atau lebih tinggi.

Contoh

Contoh kode berikut menunjukkan cara mengambil Providers koleksi dari SiteMap kelas, lalu melakukan iterasi melaluinya.

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

Jika Anda memiliki lebih dari sekadar penyedia default yang dikonfigurasi untuk situs Anda, Anda akan melihat setiap penyedia ditampilkan. Misalnya, jika Anda menggunakan sampel penyedia Microsoft Access (lihat StaticSiteMapProvider), Anda akan melihat output berikut:

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

Keterangan

Penyedia peta situs yang tercantum dalam Providers kumpulan adalah penyedia yang ditentukan dalam hierarki konfigurasi untuk menginisialisasi SiteMap kelas. Hanya penyedia default (diidentifikasi oleh Provider properti) yang dijamin akan digunakan oleh SiteMap selama inisialisasi; keberadaan penyedia dalam Providers koleksi berarti bahwa itu ditentukan dalam konfigurasi dan tersedia selama inisialisasi.

Berlaku untuk

Lihat juga