Freigeben über


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

Fügt einen Anbieter in die Auflistung von Sitenavigationsanbietern hinzu.

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

<add  
   name="provider name" 
   type="provider type"
   description="description"
   siteMapFile="path"
/>

Attribute und Elemente

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

Attribute

Attribut

Beschreibungen

description

Erforderliches String-Attribut.

Beschreibt den Siteübersichtsanbieter.

name

Erforderliches String-Attribut.

Gibt den Namen des hinzuzufügenden Anbieters an.

siteMapFile

Optionales String-Attribut.

Gibt die Datei an, die die Siteübersichtsdaten enthält. Als siteMapFile-Verweis können Sie verwenden:

  • Einen Pfadverweis, der relativ zur Anwendung verweist (z. B. ~/SiteMapFile1.sitemap).

  • Einen virtuellen Pfad, der einen Speicherort innerhalb der Verzeichnisstruktur der Anwendung zuordnet (z. B. /directory1/directory2/SiteMapFile1.sitemap).

  • Einen Pfadverweis, der relativ zum Stamm der Verzeichnisstruktur der Anwendung verweist (z. B. SiteMapFile1.sitemap).

type

Erforderliches String-Attribut.

Gibt einen Typ an, der die ProviderBase-Klasse implementiert.

Der type-Wert muss ein vollqualifizierter Assemblyverweis sein.

securityTrimmingEnabled

Der Standardwert ist false.

Wenn der Wert auf true festgelegt ist und der Anbieter die notwendige Logik bereitstellt, führt der Siteübersichtsanbieter eine Rollenprüfung der abgerufenen Knoten durch. Außerdem führt der Anbieter eine Rollenprüfung für den aktuellen Benutzer durch. Es gelten die URL-Autorisierungsregeln der Anwendung und, bei Verwendung der Microsoft Windows-Authentifizierung, auch die Dateiautorisierungsregeln der Anwendung.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element

Beschreibung

configuration

Gibt das 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.

siteMap

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

providers

Definiert eine Auflistung von Navigationsanbietern.

Hinweise

Standardkonfiguration

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

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

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

SiteMapSection.Providers

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

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Referenz

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

siteMap-Element (ASP.NET-Einstellungsschema)

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

<configuration>-Element

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

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

System.Configuration

System.Web.Configuration

Konzepte

Übersicht über die ASP.NET-Konfiguration

ASP.NET-Webserversteuerelemente und Browserfunktionen

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Weitere Ressourcen

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurationseinstellungen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurations-API