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

  • Article

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

              Version d’origine du produit : ASP.NET
Numéro de la 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 s’éloigne des mécanismes de configuration classiques du registre et de la métabase. Il n’existe actuellement aucun composant logiciel enfichable MMC (Microsoft Management Console) ou un autre outil d’administration fourni par Microsoft que vous pouvez utiliser pour créer et modifier .config fichiers.

Hiérarchie des fichiers .config

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

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 fichier Web.config doit être un document XML bien formé et 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 contiennent des éléments de configuration individuels.

L’exemple suivant montre un fichier Web.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 identique 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 . En soi, 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 <system.web> lignes et </system.web> . Ces lignes marquent le début et la fin des paramètres de configuration ASP.NET.

References