SiteMap.Providers Property

Definition

Ruft eine schreibgeschützte Auflistung von genannten SiteMapProvider-Objekten ab, die der SiteMap-Klasse zur Verfügung stehen.Gets a read-only collection of named SiteMapProvider objects that are available to the SiteMap class.

public:
 static property System::Web::SiteMapProviderCollection ^ Providers { System::Web::SiteMapProviderCollection ^ get(); };
public static System.Web.SiteMapProviderCollection Providers { get; }
member this.Providers : System.Web.SiteMapProviderCollection
Public Shared ReadOnly Property Providers As SiteMapProviderCollection

Property Value

SiteMapProviderCollection

Eine SiteMapProviderCollection von genannten SiteMapProvider-Objekten.A SiteMapProviderCollection of named SiteMapProvider objects.

Exceptions

Das Siteübersichtsfeature ist nicht aktiviert.The site map feature is not enabled.

Der in der Konfiguration angegebene Standardanbieter ist nicht vorhanden.The default provider specified in the configuration does not exist.

Das Feature wird nur unterstützt, wenn es mindestens mit niedriger Vertrauenswürdigkeit ausgeführt wird.The feature is supported only when running in Low trust or higher.

Examples

Im folgenden Codebeispiel wird veranschaulicht, wie die Providers-Auflistung aus der SiteMap-Klasse abgerufen und anschließend durchlaufen wird.The following code example demonstrates how to retrieve the Providers collection from the SiteMap class, and then iterate through it.

<%@ 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("&nbsp;&nbsp;&nbsp;");
        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("&nbsp;&nbsp;&nbsp;")
        Response.Write("<BR>")
    End While
End Sub ' Page_Load

</SCRIPT>

Wenn Sie mehr als nur den für Ihre Website konfigurierten Standardanbieter haben, sehen Sie, dass jeder Anbieter angezeigt wird.If you have more than just the default provider configured for your site, you will see each provider displayed. Wenn Sie z. b. den Microsoft Access-Beispiel Anbieter verwenden (siehe StaticSiteMapProvider), wird die folgende Ausgabe angezeigt:For example, if you are using the sample Microsoft Access provider (see StaticSiteMapProvider), you see the following output:

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

Remarks

Die in der Providers Auflistung aufgelisteten Site Übersichts Anbieter sind die in der Konfigurations Hierarchie angegebenen Site Übersichts Anbieter, um die SiteMap-Klasse zu initialisieren.The site map providers that are listed in the Providers collection are those that are specified in the configuration hierarchy to initialize the SiteMap class. Es wird sichergestellt, dass nur der Standardanbieter (der durch die Provider-Eigenschaft identifiziert wird) während der Initialisierung vom SiteMap verwendet wird. Das vorhanden sein eines Anbieters in der Providers-Auflistung bedeutet, dass er in der Konfiguration angegeben wurde und während der Initialisierung verfügbar war.Only the default provider (identified by the Provider property) is guaranteed to be used by the SiteMap during initialization; the presence of a provider in the Providers collection means that it was specified in the configuration and was available during initialization.

Applies to

See also