Partager via

siteMap, élément (Schéma des paramètres ASP.NET)

  • Article

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Définit des paramètres de configuration pour prendre en charge l'infrastructure de navigation pour la configuration, le stockage et le rendu de la navigation de site.

Cet élément est une nouveauté du .NET Framework version 2.0.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut

Description

defaultProvider

Attribut requis.

Spécifie le nom du fournisseur.

La valeur par défaut est le fournisseur XmlSiteMapProvider.

Éléments enfants

Élément

Description

providers

Définit une collection de fournisseurs de navigation.

Éléments parents

Élément

Description

configuration

Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine de la section de configuration ASP.NET.

Notes

Configuration par défaut

L'élément siteMap par défaut suivant est configuré dans le fichier Web.config racine de .NET Framework version 2.0.

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

Exemple

L'exemple de code suivant montre comment ajouter un fournisseur de plan de site dans le fichier Web.config pour substituer le fournisseur de plan de site par défaut défini pour ASP.NET.

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

Informations sur les éléments

Gestionnaire de section de configuration

System.Web.Configuration.SiteMapSection

Membre de configuration

SystemWebSectionGroup.SiteMap

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Configuration requise

Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0

.NET Framework version 2.0

Microsoft Visual Studio 2005

Voir aussi

Tâches

How to: Lock ASP.NET Configuration Settings

Référence

system.web, élément (Schéma des paramètres ASP.NET)

<configuration>, élément

providers, élément de siteMap (Schéma des paramètres ASP.NET)

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Autres ressources

ASP.NET Configuration Files

Paramètres de configuration ASP.NET

Paramètres généraux de configuration (ASP.NET)

ASP.NET Configuration API