Format du fichier de configuration
Les fichiers de configuration ASP.NET sont des fichiers texte basés sur XML, portant chacun le nom web.configuration, et pouvant apparaître dans n'importe quel répertoire d'un serveur d'application Web ASP.NET.
Chaque fichier web.config applique des paramètres de configuration au répertoire dans lequel il se trouve et à tous ses répertoires virtuels enfants. Les paramètres des répertoires enfants peuvent éventuellement substituer ou modifier les paramètres spécifiés dans les répertoires parents. Le fichier de configuration racine, WinNT\Microsoft.NET\Framework\<version>\config\machine.config, fournit les paramètres de configuration par défaut pour la totalité de l'ordinateur. ASP.NET configure IIS pour éviter que le navigateur puisse accéder directement aux fichiers web.config afin de garantir que leurs valeurs ne risquent pas d'être publiques. En cas de tentative d'accès à ces fichiers, ASP.NET retourne l'erreur 403: Accès interdit.
Au moment de l'exécution, ASP.NET utilise ces fichiers de configuration web.config pour calculer de manière hiérarchique une collection unique de paramètres pour chaque demande cible d'URL entrante (ces paramètres ne sont calculés qu'une seule fois, avant d'être mis en cache pour les demandes suivantes. ASP.NET recherche automatiquement les modifications du fichier et invalide le cache si un des fichiers de configuration est modifié).
Par exemple, les paramètres de configuration de l'URL http://myserver/myapplication/mydir/page.aspx sont calculés en appliquant les paramètres du fichier web.config dans l'ordre suivant :
Base configuration settings for machine.
C:\WinNT\Microsoft.NET\Framework\v.1.00\config\machine.config
Overridden by the configuration settings for the site (or the root application).
C:\inetpub\wwwroot\web.config
Overridden by application configuration settings.
D:\MyApplication\web.config
Overridden by subdirectory configuration settings.
D:\MyApplication\MyDir\web.config
Si un fichier web.config est présent dans le répertoire racine d'un site, par exemple « Inetpub\wwwroot », ses paramètres de configuration s'appliquent à toutes les applications de ce site. Remarquez que la présence d'un fichier web.config à la racine d'une application ou dans un répertoire donné est complètement facultative. Si aucun fichier web.config n'est présent, tous les paramètres de configuration du répertoire sont automatiquement hérités du répertoire parent.
Gestionnaires de section de configuration et sections
Un fichier web.config est un fichier texte basé sur XML contenant des éléments de document XML standard, notamment des balises au format adéquat, des commentaires, du texte, cdata, etc. Le fichier peut être au format ANSI, UTF-8 ou Unicode. Le système détecte automatiquement l'encodage.
L'élément racine d'un fichier web.config est toujours une balise <configuration>. Les paramètres ASP.NET et d'utilisateur final sont ensuite encapsulés dans la balise de la manière suivante :
<configuration>
<!- Configuration settings would go here. -->
</configuration>
La balise <configuration> contient généralement trois types d'éléments différents : 1) les déclarations du gestionnaire de section de configuration, 2) les groupes de sections de configuration et 3) les paramètres de la section de configuration.
- Gestionnaires de section de configuration - L'infrastructure de configuration ASP.NET ne fait aucune supposition en ce qui concerne le format de fichier ou les paramètres pris en charge dans un fichier web.config. En effet, elle délègue le traitement des données du fichier web.config aux gestionnaires de section de configuration (classes .NET Framework implémentant l'interface IConfigurationSectionHandler). Il suffit à une déclaration IConfigurationSectionHandler d'apparaître qu'une seule fois, généralement dans le fichier machine.config. Les fichiers web.config des répertoires enfants héritent automatiquement de cette déclaration. Les gestionnaires de section de configuration sont déclarés au sein d'un ficher web.config utilisant des directives de balises de section imbriquées dans une balise <configSections>. Les balises de section peuvent être qualifiées davantage par des balises de groupes de sections afin de les organiser en groupes logiques (voir ci-dessous). Chaque balise de section identifie un nom de balise indiquant une section spécifique des données de configuration et une classe IConfigurationSectionHandler associée qui les traite.
- Groupes de sections de configuration - La configuration ASP.NET permet le regroupement hiérarchique de sections à des fins organisationnelles. Une balise <sectionGroup> peut figurer dans une balise <configSections> ou au sein d'autres balises <sectionGroup>. Par exemple, les gestionnaires de section ASP.NET appartiennent tous au groupe de sections <system.web>.
- Sections de configuration - Les paramètres de configuration ASP.NET sont représentés dans des sections de balises de configuration, également imbriquées dans une balise <configuration> (et dans des balises de groupe de sections facultatives). Pour chaque section de configuration, un gestionnaire de section approprié doit être défini dans la hiérarchie de la configuration. Dans l'exemple ci-dessous, la balise <httpModules> est la section de configuration qui définit les données de configuration des modules HTTP. La classe System.Configuration.HttpModulesConfigurationHandler est responsable de l'interprétation du contenu de la balise <httpModules> au moment de l'exécution. Remarquez que la définition du gestionnaire de section et la section doivent posséder le même qualificateur de groupe de section (dans ce cas-ci, <system.web>). Remarquez également que les noms de balises respectent la casse et doivent être tapés exactement de la manière indiquée. De nombreux attributs et paramètres de ASP.NET sont également sensibles à la casse et ne sont pas examinés par le runtime de configuration si la casse ne correspond pas.
<configuration>
<configSections>
<sectionGroup name="system.web">
<section
name="httpModules"
type="System.Web.Configuration.HttpModulesConfigurationHandler,System.Web"
/>
</sectionGroup>
</configSections>
<system.web>
<httpModules>
<add
name="CookielessSession"
type="System.Web.SessionState.CookielessSessionModule,System.Web"
/>
<add
name="OutputCache"
type="System.Web.Caching.OutputCacheModule,System.Web"
/>
<add
name="Session"
type="System.Web.SessionState.SessionStateModule,System.Web"
/>
<add
name="WindowsAuthentication"
type="System.Web.Security.WindowsAuthenticationModule,System.Web"
/>
<add
name="FormsAuthentication"
type="System.Web.Security.FormsAuthenticationModule,System.Web"
/>
<add
name="PassportAuthentication"
type="System.Web.Security.PassportAuthenticationModule,System.Web"
/>
<add
name="UrlAuthorization"
type="System.Web.Security.UrlAuthorizationModule,System.Web"
/>
<add
name="FileAuthorization"
type="System.Web.Security.FileAuthorizationModule,System.Web"
/>
</httpModules>
</system.web>
</configuration>
Utilisation de l'emplacement et du chemin d'accès
Par défaut, tous les paramètres de configuration définis dans la balise <configuration> de niveau supérieur sont appliqués à l'emplacement du répertoire actif du fichier web.config contenant et à tous ses chemins d'accès enfants. Vous pouvez éventuellement appliquer les paramètres de configuration à des chemins d'accès enfants spécifiques situés sous le fichier de configuration en cours en utilisant la balise <location> avec un attribut path de contrainte correcte. Si le fichier de configuration est le fichier machine.config principal, vous pouvez appliquer les paramètres à des répertoires ou applications virtuels spécifiques. Si le fichier de configuration est un fichier web.config, vous pouvez appliquer les paramètres à un fichier, un répertoire enfant, un répertoire virtuel ou une application spécifique.
<configuration>
<location path="EnglishPages">
<system.web>
<globalization
requestEncoding="iso-8859-1"
responseEncoding="iso-8859-1"
/>
</system.web>
</location>
<location path="EnglishPages/OneJapanesePage.aspx">
<system.web>
<globalization
requestEncoding="Shift-JIS"
responseEncoding="Shift-JIS"
/>
</system.web>
</location>
</configuration>
Verrouillage des paramètres de configuration
Outre la spécification des informations de chemin d'accès à l'aide de la balise <location>, vous pouvez également configurer la sécurité afin que les paramètres ne puissent pas être substitués par un autre fichier de configuration situé à un niveau inférieur de la hiérarchie de la configuration. Pour verrouiller un groupe de paramètres, vous pouvez spécifier un attribut allowOverride sur la balise <location> qui l'entoure et lui affecter la valeur false. Le code suivant verrouille les paramètres d'emprunt d'identité pour deux applications différentes.
<configuration>
<location path="app1" allowOverride="false">
<system.web>
<identity impersonate="false" userName="app1" password="app1pw" />
</system.web>
</location>
<location path="app2" allowOverride="false">
<system.web>
<identity impersonate="false" userName="app2" password="app2pw" />
</system.web>
</location>
</configuration>
Remarquez que si un utilisateur tente de substituer ces paramètres dans un autre fichier de configuration, le système de configuration affiche une erreur :
<configuration>
<system.web>
<identity userName=
"developer" password="loginpw" />
</system.web>
</configuration>
Section de configuration ASP.NET standard
ASP.NET est fourni avec une série de gestionnaires de section de configuration standard servant à traiter les paramètres de configuration au sein des fichiers web.config. Le tableau suivant fournit une brève description des sections, ainsi que des pointeurs vers des informations supplémentaires.
|
Vérifiez
