add, élément de providers pour siteMap (Schéma des paramètres ASP.NET)
[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.]
Ajoute un fournisseur à la collection de fournisseurs de navigation.
Cet élément est une nouveauté du .NET Framework version 2.0.
<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 :
|
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 de .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 |
|
Membre de configuration |
|
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
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)
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)
Concepts
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Autres ressources
Paramètres de configuration ASP.NET