SiteMap.Provider Eigenschaft

  • Referenz

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

Ruft das SiteMapProvider-Standardobjekt für die aktuelle Siteübersicht ab.

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

Eigenschaftswert

SiteMapProvider

Der Standard-Siteübersichtsanbieter für die SiteMap.

Ausnahmen

InvalidOperationException

Das Siteübersichtsfeature ist nicht aktiviert.

ConfigurationErrorsException

Der in der Konfiguration angegebene Standardanbieter ist nicht vorhanden.

HttpException

Das Feature wird nur unterstützt, wenn es mindestens mit niedriger Vertrauenswürdigkeit ausgeführt wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der statischen Provider Eigenschaft auf das Standardobjekt SiteMapProvider für die Website zugreifen.

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

Hinweise

Standardmäßig wird das XmlSiteMapProvider Objekt verwendet und Websitenavigationsdaten aus der Web.sitemap-Datei geladen, die sich im Stammverzeichnis der Website befindet. Dies wird in den Verwaltungsklassen identifiziert, die die Websitenavigationskonfiguration und den Abschnitt "Websitezuordnungskonfiguration" der Web.config-Dateien verwalten. Standardmäßig ist es eine Instanz der XmlSiteMapProvider Klasse, die die Web.sitemap-Datei als beständigen Speicher verwendet. Sie können jedoch ihr eigenes Standortzuordnungsspeicher- und Konfigurationsschema implementieren, indem Sie eine Klasse schreiben, die die abstrakte SiteMapProvider Klasse implementiert. Weitere Informationen zum Schreiben Ihres eigenen Anbieters finden Sie unter SiteMapProvider.

Gilt für

Siehe auch