Créer le fichier Web.config pour une application ASP.NET

Cet article explique comment créer le fichier Web.config utilisé pour contrôler le comportement des applications ASP.NET individuelles.

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

Résumé

Microsoft .NET Framework, et ASP.NET en particulier, utilise des fichiers .config au format XML pour configurer des applications. Cette pratique diffère des mécanismes de configuration de registre et de métabase conventionnels. Il n’existe actuellement aucun composant logiciel enfichable Microsoft Management Console (MMC) ou un autre outil d’administration fourni par Microsoft que vous pouvez utiliser pour créer et modifier des fichiers .config.

Hiérarchie des fichiers .config

Le .NET Framework s’appuie sur .config fichiers pour définir des options de configuration. Les fichiers .config sont des fichiers XML textuels. Plusieurs fichiers .config peuvent, et le font généralement, exister sur un seul système.

Les paramètres de configuration à l’échelle du système pour le .NET Framework sont définis dans le fichier Machine.config . Le fichier Machine.config se trouve dans le %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ dossier. Les paramètres par défaut contenus dans le fichier Machine.config peuvent être modifiés pour affecter le comportement des applications Microsoft .NET sur l’ensemble du système.

Vous pouvez modifier les paramètres de configuration ASP.NET pour une seule application si vous créez un fichier Web.config dans le dossier racine de l’application. Dans ce cas, les paramètres du fichier Web.config remplacent les paramètres du fichier Machine.config .

Créer un fichier Web.config

Vous pouvez créer un fichier Web.config à l’aide d’un éditeur de texte tel que le Bloc-notes. Vous devez créer un fichier texte nommé Web.config dans le répertoire racine de votre application ASP.NET. Le fichierWeb.config doit être un document XML bien formé et doit avoir un format similaire au %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config fichier.

Le fichier Web.config doit contenir uniquement des entrées pour les éléments de configuration qui remplacent les paramètres du fichier Machine.config . Au minimum, le fichier Web.config doit avoir l’élément <configuration> et l’élément <system.web> . Ces éléments contiendront des éléments de configuration individuels.

L’exemple suivant montre un fichier deWeb.config minimal :

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.web>
    </system.web>
</configuration>

La première ligne du fichier Web.config décrit le document au format XML et spécifie le type d’encodage de caractères. Cette première ligne doit être la même pour tous les fichiers .config.

Les lignes qui suivent marquent le début et la fin de l’élément <configuration> et l’élément <system.web> du fichier Web.config . Par eux-mêmes, ces lignes ne font rien. Toutefois, les lignes fournissent une structure qui vous permet d’ajouter des paramètres de configuration futurs. Vous ajoutez la majorité des paramètres de configuration ASP.NET entre les lignes et </system.web> les <system.web> lignes. Ces lignes marquent le début et la fin des paramètres de configuration ASP.NET.

References