Aracılığıyla paylaş

SiteMap.Providers Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web
Bütünleştirilmiş Kod:
System.Web.dll

Sınıfında kullanılabilen SiteMap adlandırılmış SiteMapProvider nesnelerin salt okunur bir koleksiyonunu alır.

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

Özellik Değeri

SiteMapProviderCollection

SiteMapProviderCollection Adlandırılmış SiteMapProvider nesnelerden biri.

Özel durumlar

InvalidOperationException

Site haritası özelliği etkinleştirilmedi.

ConfigurationErrorsException

Yapılandırmada belirtilen varsayılan sağlayıcı yok.

HttpException

Bu özellik yalnızca Düşük güven veya daha yüksek bir değerde çalışırken desteklenir.

Örnekler

Aşağıdaki kod örneği, sınıfından Providers koleksiyonun SiteMap nasıl alınıp daha sonra yineleme yapılacağını gösterir.

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

Siteniz için yalnızca varsayılan sağlayıcıdan daha fazlasını yapılandırdıysanız, her sağlayıcının görüntülendiğini görürsünüz. Örneğin, örnek Microsoft Access sağlayıcısını kullanıyorsanız (bkzStaticSiteMapProvider. ) aşağıdaki çıkışı görürsünüz:

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

Açıklamalar

Koleksiyonda Providers listelenen site haritası sağlayıcıları, sınıfı başlatmak SiteMap için yapılandırma hiyerarşisinde belirtilenlerdir. Yalnızca varsayılan sağlayıcının (özellik tarafından Provider tanımlanan) başlatma sırasında kullanılması SiteMap garanti edilir; koleksiyondaki Providers bir sağlayıcının varlığı, yapılandırmada belirtildiği ve başlatma sırasında kullanılabilir olduğu anlamına gelir.

Şunlara uygulanır

Ayrıca bkz.