Modification des fichiers de configuration ASP.NET
Mise à jour : novembre 2007
Les données de configuration ASP.NET sont stockées dans des fichiers texte XML nommés Web.config. Les fichiers Web.config peuvent apparaître dans plusieurs répertoires d'applications ASP.NET. Chaque fichier Web.config applique des paramètres de configuration à son propre répertoire et à tous les répertoires enfants situés au-dessous de lui. Les paramètres dans les répertoires enfants peuvent éventuellement substituer ou modifier des paramètres spécifiés dans les répertoires parents. La racine de la hiérarchie de configuration ASP.NET est le fichier systemroot\Microsoft.NET\Framework\numéro_version\CONFIG\Web.config, lequel inclut des paramètres s'appliquant à toutes les applications ASP.NET qui exécutent une version spécifique de Microsoft .NET Framework. Dans la mesure où chaque application ASP.NET hérite des paramètres de configuration par défaut du fichier Web.config racine, vous devez créer des fichiers Web.config uniquement pour les paramètres qui se substituent aux paramètres par défaut.
Structure de fichier de configuration
Chaque fichier de configuration contient des balises et des sous-balises XML imbriquées qui spécifient les paramètres de configuration. Toutes les informations de configuration figurent entre les balises XML racines <configuration> et </configuration>. Les informations de configuration figurant entre ces balises sont regroupées en deux zones principales : la zone des déclarations des gestionnaires de sections de configuration et la zone des paramètres de sections de configuration. Pour plus d'informations, consultez Structure du fichier de configuration ASP.NET (sections et gestionnaires de sections).
Modification des paramètres de configuration
Comme il s'agit de fichiers XML en texte brut, vous pouvez créer ou modifier des paramètres de configuration de plusieurs façons :
À l'aide de l'API de configuration ASP.NET. Pour plus d'informations, consultez API de configuration ASP.NET.
En utilisant le composant logiciel enfichable MMC ASP.NET.
À l'aide de l'outil Administration de site Web pour les sites Web et les applications ASP.NET. Pour plus d'informations, consultez Outil Administration de site Web ASP.NET.
À l'aide d'un éditeur de texte ou d'un éditeur XML pour modifier directement les fichiers de configuration. Pour en savoir plus sur la syntaxe à utiliser, consultez les rubriques de référence sur la configuration dans Paramètres de configuration ASP.NET et Paramètres généraux de configuration (ASP.NET).
Respect de la casse
Étant donné que les balises doivent être au format XML correct, les balises, les sous-balises et les attributs respectent la casse. Les noms de balises et d'attributs sont de casse mixte, ce qui signifie que le premier caractère d'un nom de balise est en minuscules et que la première lettre du ou des mots concaténés suivants est en majuscules. Dans la plupart des cas, les valeurs des attributs de chaîne sont de casse Pascal, ce qui signifie que le premier caractère est en majuscules, tout comme la première lettre du ou des mots concaténés suivants. Les exceptions sont true et false, qui sont toujours en minuscules.
Sections personnalisées
L'infrastructure de configuration ASP.NET ne fait aucune supposition quant aux types de données de configuration qu'elle prend en charge. Les classes de gestionnaire de section de configuration traitent toutes les données Web.config. Vous pouvez utiliser les gestionnaires prédéfinis fournis avec le .NET Framework ou créer les vôtres pour traiter vos données de configuration personnalisées.
Pour plus d'informations sur la création de types de configuration personnalisée, consultez Comment : créer des sections de configuration personnalisées à l'aide de ConfigurationSection.
Modification des fichiers de configuration distants
L'API de configuration ASP.NET permet à votre application de modifier les fichiers de configuration sur un ordinateur distant. Vous pouvez notamment modifier le fichier Machine.config ou un fichier Web.config dans une application Microsoft Internet Information Services (IIS), ou dans ses répertoires enfants, sur un serveur distant. Si le fichier Web.config n'existe pas, les données de configuration retournées représentent exclusivement des paramètres hérités, qui s'appliquent au chemin d'accès spécifié. Si votre application demande une mise à jour de ces données de configuration retournées, un nouveau fichier est créé. Pour plus d'informations, consultez Modification des fichiers de configuration distants ASP.NET et Comment : accéder à distance aux fichiers de configuration ASP.NET et les modifier.
Redémarrage du domaine d'application en cas de modifications de configuration
La modification de paramètres de configuration dans les fichiers Web.config provoque indirectement le redémarrage du domaine d'application. Ce comportement est dû au design. Vous pouvez éventuellement utiliser l'attribut configSource pour référencer des fichiers de configuration externes qui ne provoquent pas de redémarrage en cas de modifications. Pour plus d'informations, consultez configSource dans Attributs généraux hérités par les éléments Section.
Toute tentative de modification d'un fichier de configuration par une personne non autorisée à le modifier ne provoquera pas de redémarrage du domaine d'application.
Pour plus d'informations, consultez Gestion des modifications apportées aux paramètres de configuration.
Voir aussi
Tâches
Comment : accéder à distance aux fichiers de configuration ASP.NET et les modifier
Comment : créer des sections de configuration personnalisées à l'aide de ConfigurationSection
Concepts
Sécurisation de la configuration ASP.NET
Modification des fichiers de configuration distants ASP.NET
Gestion des modifications apportées aux paramètres de configuration