Partager via

Définir des paramètres de configuration spécifiques à l’application et à l’annuaire dans une application ASP.NET

Cet article explique comment définir des paramètres de configuration spécifiques à l’application et des répertoires dans ASP.NET.

Version du produit d’origine : ASP.NET
Numéro de base de connaissances d’origine : 815174

Résumé

Le fichier Web.config se trouve dans le répertoire racine d’une application ASP.NET. Le fichier Web.config spécifie les informations de configuration spécifiques à l’application. Vous pouvez également définir des paramètres de configuration par annuaire. Pour cela, il existe deux méthodes :

  • Distribuez plusieurs fichiers Web.config aux répertoires de l’application. Ajoutez un fichier Web.config dans le répertoire d’application ASP.NET avec des paramètres qui remplacent les paramètres dans un fichier Web.config de niveau supérieur ou dans le fichier de configuration de l’ordinateur système (Machine.config).

  • Ajoutez des paramètres par répertoire ou par fichier directement au fichier Web.config de l’application. Cette méthode utilise un seul fichier Web.config pour activer les paramètres de configuration par répertoire. Vous pouvez également utiliser cette méthode dans le fichier Machine.config pour forcer les paramètres de configuration sur ASP.NET applications web, puis pour empêcher les fichiers Web.config de remplacer les paramètres Machine.config .

Utiliser l’élément location dans le fichier Machine.config

Pour spécifier des paramètres qui s’appliquent à une application web ou à un répertoire, vous pouvez ajouter l’élément <location> à l’élément <configuration> d’un fichier System Machine.config . Il est utile de centraliser les paramètres de configuration dans un seul fichier. Il est également utile dans les environnements d’hébergement web pour imposer des paramètres de configuration spécifiques sur des applications web individuelles.

L’élément <location> contient deux attributs et allowOverridepath . L’attribut path définit le site ou le répertoire virtuel couvert par les paramètres de configuration. Pour spécifier que les paramètres de l’élément <location> s’appliquent au site Web par défaut, définissez l’attribut path Default Web Sitesur . Pour spécifier que les paramètres s’appliquent à l’application nommée MyApp dans le site web par défaut, définissez l’attribut path sur Default Web Site/MyApp.

Lorsque l’attribut allowOverride est false, les fichiers Web.config dans les répertoires d’applications web ne peuvent pas remplacer les paramètres que vous avez spécifiés dans l’élément <location> . Il s’agit d’un paramètre utile dans les environnements où vous devez restreindre les développeurs d’applications dans la façon dont ils configurent une application web. L’exemple suivant montre une partie d’un fichier Machine.config . Le fichier nécessite l’authentification pour accéder à l’application MyApp sur le site Web par défaut et ne peut pas être substitué par les paramètres d’un fichier Web.config .

<configuration>
    <location path="Default Web Site/MyApp" allowOverride="false">
        <system.web>
            <authorization>
                <allow users="?" />
            </authorization>
        </system.web>
    </location>
</configuration>

Utiliser l’élément location dans le fichier Web.config

Pour spécifier des paramètres qui s’appliquent à une application ou un répertoire spécifique, ajoutez l’élément <location> à l’élément <configuration> d’un fichier Web.config d’application. L’élément <location> contient généralement un <system.web> élément et d’autres éléments de configuration exactement comme vous les utilisez dans le fichier Web.config . L’attribut path de l’élément <location> spécifie le répertoire virtuel ou le nom de fichier où les éléments de configuration d’emplacement s’appliquent. L’exemple suivant montre une partie d’un fichier Web.config d’application qui spécifie des messages d’erreur personnalisés pour le répertoire virtuel du forum.

<configuration>
    <location path="forum" >
        <system.web>
            <customErrors mode="RemoteOnly" defaultRedirect="forum-error.aspx">
                <error statusCode="404" redirect="forum-file-not-found.aspx" />
            </customErrors>
        </system.web>
    </location>
</configuration>

References