SiteMap.Providers Vlastnost

Reference

Definice

Obor názvů:: System.Web

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá jen pro čtení kolekci pojmenovaných SiteMapProvider objektů, které jsou k dispozici pro SiteMap třídu .

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

Hodnota vlastnosti

SiteMapProviderCollection

A SiteMapProviderCollection z pojmenovaných SiteMapProvider objektů.

Výjimky

InvalidOperationException

Funkce mapy webu není povolená.

ConfigurationErrorsException

Výchozí zprostředkovatel zadaný v konfiguraci neexistuje.

HttpException

Tato funkce je podporována pouze v případě, že je spuštěna s nízkou důvěryhodností nebo vyšší.

Příklady

Následující příklad kódu ukazuje, jak načíst kolekci Providers SiteMap z třídy a pak ji iterovat.

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

Pokud máte pro svůj web nakonfigurovaných více než jen výchozího poskytovatele, zobrazí se všichni poskytovatelé. Pokud například používáte ukázkovou Microsoft zprostředkovatele Accessu (viz StaticSiteMapProvider), zobrazí se následující výstup:

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

Poznámky

Zprostředkovatelé mapy webu, kteří jsou uvedeni Providers v kolekci, jsou ti, kteří jsou zadáni v hierarchii konfigurace pro inicializaci SiteMap třídy. Při inicializaci je zaručeno použití SiteMap pouze výchozího zprostředkovatele (určeného Provider vlastností). Přítomnost zprostředkovatele v Providers kolekci znamená, že byl zadán v konfiguraci a byl během inicializace k dispozici.

Platí pro