siteMap-Element (ASP.NET-Einstellungsschema)

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Definiert Konfigurationseinstellungen zur Unterstützung der Navigationsinfrastruktur für das Konfigurieren, Speichern und Rendern der Sitenavigation.

Dieses Element ist neu in .NET Framework, Version 2.0.

<siteMap
  defaultProvider="provider name">
  <providers>...</providers> 
</siteMap>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
defaultProvider	Erforderliches Attribut. Gibt den Namen des Anbieters an. Standardwert ist der XmlSiteMapProvider-Anbieter.

Untergeordnete Elemente

Element	Beschreibung
providers	Definiert eine Auflistung von Navigationsanbietern.

Übergeordnete Elemente

Element	Beschreibung
configuration	Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
system.web	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Hinweise

Standardkonfiguration

Das folgende siteMap-Standardelement wird in der Stammdatei Web.config von .NET Framework, Version 2.0, konfiguriert.

<siteMap>
     <providers>
           <add siteMapFile="web.sitemap" name="AspNetXmlSiteMapProvider"
                type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.0.0, Culture=neutral, 
                PublicKeyToken=b03f5f7f11d50a3a" />
     </providers>
</siteMap>

Beispiel

Das folgende Beispiel zeigt, wie Sie einen Siteübersichtsanbieter in die Datei Web.config einfügen und damit den Standard-Siteübersichtsanbieter für ASP.NET überschreiben.

<configuration>
  <system.web>
    <siteMap defaultProvider="XmlSiteMapReader">
      <providers>
        <add 
          name=" XmlSiteMapReader"
          type="XmlSiteMapProvider, System.Web, Version=1.1.3300.0,
                Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
          siteMapFile="my.sitemap" 
          description="XmlSiteMapProvider that loads my.sitemap"/>
      </providers>
    </siteMap>
  </system.web>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler	System.Web.Configuration.SiteMapSection
Konfigurationsmember	SystemWebSectionGroup.SiteMap
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene
Anforderungen	Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 2.0 Microsoft Visual Studio 2005

Siehe auch

Aufgaben

How to: Lock ASP.NET Configuration Settings

Referenz

system.web-Element (ASP.NET-Einstellungsschema)

<configuration>-Element

providers-Element für siteMap (ASP.NET-Einstellungsschema)

System.Configuration

System.Web.Configuration

Konzepte

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Weitere Ressourcen

ASP.NET Configuration Files

ASP.NET-Konfigurationseinstellungen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET Configuration API