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

Mise à jour : novembre 2007

Ajoute un fournisseur à la collection de fournisseurs de navigation.

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

configuration, élément (Schéma des paramètres généraux)
  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)
        add, élément de providers pour siteMap (Schéma des paramètres ASP.NET)

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

Attributs et éléments

Les sections suivantes décrivent les attributs ainsi que les éléments parents et enfants.

Attributs

Attribut	Description
description	Attribut String requis. Décrit le fournisseur de plan de site.
name	Attribut String requis. Spécifie le nom du fournisseur à ajouter.
siteMapFile	Attribut String facultatif. Spécifie le fichier qui contient les données de plan de site. La référence siteMapFile peut être l'un des éléments suivants : une référence de chemin d'accès relative à l'application (par exemple, ~/SiteMapFile1.sitemap) ; un chemin d'accès virtuel mappé à un emplacement faisant partie de la structure de répertoires de l'application (par exemple, /directory1/directory2/SiteMapFile1.sitemap) ; une référence de chemin d'accès relative à la racine de la structure de répertoires de l'application (par exemple, SiteMapFile1.sitemap).
type	Attribut String requis. Spécifie un type qui implémente la classe ProviderBase. La valeur type doit être une référence d'assembly qualifiée complète.
securityTrimmingEnabled	La valeur par défaut est false. Si la valeur est true et que le fournisseur de plan de site comprend la logique requise, il procède à un contrôle des rôles sur les nœuds récupérés. Le fournisseur vérifie également les rôles pour l'utilisateur actuel. Les règles d'autorisation d'URL de l'application sont appliquées et, si l'authentification Microsoft Windows est utilisée, les règles d'autorisation de fichiers de l'application le sont également.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
configuration	Spécifie l'élément racine 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.
providers	Définit une collection de fournisseurs de navigation.

Notes

Configuration par défaut

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

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

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

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

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

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

<configuration>, élément

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