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

  • Article

Mise à jour : novembre 2007

Définit une collection de fournisseurs de navigation.

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

<configuration>, élément
  system.web, élément (Schéma des paramètres ASP.NET)
    siteMap, élément (Schéma des paramètres ASP.NET)
      providers, élément de siteMap (Schéma des paramètres ASP.NET)

<providers> 
  <add.../> 
  <remove.../> 
  <clear/> 
</providers>

Attributs et éléments

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

Attributs

Aucun.

Éléments enfants

Élément

Description

add

Élément facultatif.

Ajoute un fournisseur à une collection de fournisseurs de navigation.

clear

Élément facultatif.

Supprime tous les fournisseurs précédemment définis.

remove

Élément facultatif.

Supprime un fournisseur de la 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.

siteMap

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.

Notes

Configuration par défaut

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

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

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

SiteMapSection.Providers

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

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la configuration ASP.NET

Fonctionnalités des contrôles serveur Web ASP.NET et du navigateur

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Référence

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

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

<configuration>, élément

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

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

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

System.Configuration

System.Web.Configuration

Autres ressources

Fichiers de configuration ASP.NET

Paramètres de configuration ASP.NET

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

API de configuration ASP.NET