Comment : créer des fichiers Web.config

Article
10/22/2014

Mise à jour : novembre 2007

ASP.NET utilise une hiérarchie de fichiers texte XML, tous nommés Web.config, pour stocker des paramètres qui contrôlent le fonctionnement de votre site Web. À l'aide des fonctionnalités du système de configuration ASP.NET, vous pouvez configurer un serveur complet, une application ASP.NET ou des pages individuelles. Cette rubrique décrit comment créer un fichier Web.config dans Visual Web Developer.

Pour créer un fichier Web.config

Dans l'Explorateur de solutions, cliquez sur l'icône Actualiser pour vous assurer qu'un fichier Web.config n'existe pas déjà dans votre application.

Si vous avez déjà utilisé l'outil Administration de site Web ou quelque autre moyen pour configurer votre application, un fichier Web.config a pu être créé automatiquement. Cliquez sur Actualiser pour mettre à jour votre liste de fichiers.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom de votre site Web, puis cliquez sur Ajouter un nouvel élément.
Dans la fenêtre Modèles, cliquez sur Fichier de configuration Web.

Le nom de fichier dans la zone de texte Nom doit être Web.config. Vous pouvez donner un autre nom au fichier, mais il s'agit de la valeur par défaut. L'extension de nom de fichier .config est protégée des téléchargements par ASP.NET.
Cliquez sur Ajouter pour créer le fichier et l'ouvrir pour le modifier.

Le fichier contient le code indiqué ultérieurement dans la section « Exemple » de cette rubrique, avec quelques valeurs initiales par défaut. Votre application hérite de tous les paramètres de configuration des fichiers Machine.config et Web.config dans le répertoire %SystemRoot%\Microsoft.NET\Framework\<version>\CONFIG, mais vous ne verrez pas ces paramètres par défaut ici. Les fichiers Web.config situés au niveau de l'application ou du répertoire doivent seulement être créés si vous souhaitez substituer les paramètres par défaut hérités ou les ajouter aux éléments de collection tels que httpHandlers, élément (Schéma des paramètres ASP.NET).

Pour afficher tous les paramètres de configuration de votre application actuelle, vous pourriez exécuter le code inclus dans la rubrique Comment : afficher des paramètres de configuration locaux et hérités par programme. Vous pouvez également consulter les fichiers Machine.config.comments ou Web.config.comments (lesquels contiennent également des commentaires utiles) dans le répertoire %SystemRoot%\Microsoft.NET\Framework\<version>\CONFIG, mais ces deux fichiers ne contiendront pas tous vos paramètres Comment : afficher des paramètres de configuration locaux et hérités par programme au moment de l'exécution.
Si vous avez modifié votre fichier Web.config, enregistrez-le.

L'enregistrement d'un fichier Web.config redémarre l'application. Vous pouvez également utiliser l'attribut configSource des éléments de section pour pointer sur un fichier de configuration secondaire qui ne provoque pas de redémarrage de l'application lorsqu'il est modifié. Pour plus d'informations, consultez configSource dans Attributs généraux hérités par les éléments Section.

Pour utiliser IntelliSense pour modifier des paramètres de configuration

Dans Visual Web Developer, ouvrez votre fichier Web.config.
Dans la fenêtre d'édition, placez votre curseur à l'intérieur des balises <system.web> </system.web> sur une ligne, mais pas à l'intérieur d'une autre balise.
Tapez le caractère inférieur à (<) pour démarrer un nouvel élément.

Une liste déroulante apparaît et propose des éléments valides à ajouter à ce point d'insertion. Vous pouvez également appuyer sur Ctrl+J pour afficher la liste déroulante sans taper le caractère inférieur à.
Sélectionnez anonymousIdentification.

L'élément anonymousIdentification, élément (Schéma des paramètres ASP.NET) est placé dans votre fichier Web.config et est terminé. Si un élément est terminé par une balise de fermeture, il y a des éléments enfants disponibles que vous pouvez définir. Si un élément est terminé, comme l'élément anonymousIdentification suivant, il n'y a pas d'élément enfant disponible à définir.
```
<anonymousIdentification />
```
Placez votre curseur à l'intérieur de la balise <anonymousIdentification />, puis appuyez sur la touche ESPACE.

Une liste déroulante apparaît et propose des attributs valides à ajouter à l'élément anonymousIdentification. Vous pouvez également appuyer sur Ctrl+J pour afficher la liste déroulante sans appuyer sur la touche ESPACE.
Sélectionnez enabled.

L'attribut enabled est placé dans votre fichier Web.config, et comme il s'agit d'un attribut Boolean, les valeurs true et false sont proposées dans une liste déroulante.
Sélectionnez false. Il s'agit du système par défaut.

Le système IntelliSense suggère des éléments et des attributs disponibles au point d'insertion. Il arrive que les attributs spécialisés ne soient pas proposés. Par exemple, lors de la configuration d'un élément providers, tel que pour l'élément siteMap, élément (Schéma des paramètres ASP.NET), différents attributs sont disponibles selon le type de fournisseur que vous ajoutez. IntelliSense n'affiche pas ces attributs parce qu'ils dépendent de la valeur de l'attribut type.
Changez la valeur de l'attribut enabled en "falsex", qui est une valeur non valide.

Le système IntelliSense fournit un contrôle de validation qui affiche une ligne ondulée sous le texte non valide.

Exemple

L'exemple de code suivant illustre le contenu initial d'un fichier Web.config créé par Visual Web Developer. Les paramètres par défaut sont donnés pour les éléments compilation et authentification. Pour activer le débogage ASP.NET, vous devez simplement changer l'attribut debug de l'élément compilation en true. Tous les éléments qui peuvent apparaître dans l'élément system.web sont documentés dans Paramètres de configuration ASP.NET.

<?xml version="1.0"?>
<!-- 
    Note: As an alternative to hand editing this file you can use the 
    Web Site Administration Tool to configure settings for your application. Use
    the Web site->Asp.Net Configuration option in Visual Studio.
    A full list of settings and comments can be found in 
    machine.config.comments usually located in 
    \Windows\Microsoft.Net\Framework\v2.x\Config 
-->
<configuration xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">
    <appSettings/>
    <connectionStrings/>
    <system.web>
        <!-- 
            Set compilation debug="true" to insert debugging 
            symbols into the compiled page. Because this 
            affects performance, set this value to true only 
            during development.
        -->
        <compilation debug="false"/>
        <!--
            The <authentication> section enables configuration 
            of the security authentication mode used by 
            ASP.NET to identify an incoming user. 
        -->
        <authentication mode="Windows"/>
        <!--
            The <customErrors> section enables configuration 
            of what to do if/when an unhandled error occurs 
            during the execution of a request. Specifically, 
            it enables developers to configure html error pages 
            to be displayed in place of a error stack trace.

        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
            <error statusCode="403" redirect="NoAccess.htm"/>
            <error statusCode="404" redirect="FileNotFound.htm"/>
        </customErrors>
        -->
    </system.web>
</configuration>

Sécurité

Lorsque vous stockez des informations sensibles dans un fichier de configuration pour une application, il est conseillé de chiffrer les valeurs sensibles à l'aide de la configuration protégée. Pour plus d'informations sur les problèmes de sécurité sur les fichiers de configuration, consultez Sécurisation de la configuration ASP.NET.