Comment faire pour créer le fichier Web.config pour une application ASP.NET

Traductions disponibles Traductions disponibles
Numéro d'article: 815179 - Voir les produits auxquels s'applique cet article
Agrandir tout | Réduire tout

Sommaire

Résumé

Cet article décrit étape par étape comment créer le fichier Web.config pour une application ASP.NET. Le .NET Framework, et ASP.NET en particulier, utilise des fichiers .config au format XML pour configurer des applications. Cette pratique vient des mécanismes de configuration conventionnels du Registre et de la métabase. Il n'y a actuellement aucun composant logiciel enfichable de la console MMC (Microsoft Management Console ) ni aucun autre outil d'administration fourni par Microsoft disponible pour créer et modifier des fichiers .config.

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

Retour au début

Hiérarchie des fichiers .config

Le .NET Framework repose sur des fichiers .config pour définir les options de configuration. Les fichiers .config sont des fichiers texte de type XML. Un même système peut comporter plusieurs fichiers .config, ce qui est généralement le cas.

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

Vous pouvez modifier les paramètres de configuration ASP.NET d'une seule application en créant un fichier Web.config dans le dossier racine de l'application. Dans ce cas, les paramètres du fichier Web.config se substituent aux paramètres du fichier Machine.config.

Retour au début

Création d'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 appelé Web.config dans le répertoire racine de votre application ASP.NET. Ce fichier doit être un document XML bien formé et avoir un format semblable au fichier %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config.

Il ne doit contenir que les entrées des éléments de configuration qui se substituent aux paramètres du fichier Machine.config. Au minimum, le fichier Web.config doit contenir les éléments <configuration> et <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 précise que le document est au format XML et spécifie le type de codage des caractères. Elle doit être identique pour tous les fichiers .config.

Les lignes qui suivent signalent le début et la fin des éléments <configuration> et <system.web> du fichier Web.config Ces lignes proprement dites ne font rien. Toutefois, elles fournissent une structure qui vous permet d'ajouter des paramètres de configuration futurs. Vous ajoutez la plupart des paramètres de configuration ASP.NET entre les lignes <system.web> et </system.web>. Elles signalent le début et la fin des paramètres de configuration ASP.NET.

Retour au début

Références

Pour plus d'informations sur la configuration ASP.NET et le format des fichiers de configuration ASP.NET, consultez la documentation du Kit de développement (SDK) .NET Framework ou reportez-vous aux sites Web Microsoft suivants :

http://msdn2.microsoft.com/en-us/library/aa719558(VS.71).aspx (en anglais)

http://msdn2.microsoft.com/en-us/library/ackhksh7(vs.71).aspx

Pour plus d'informations, cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft.
815178Comment faire pour modifier la configuration d'une application ASP.NET
Retour au début

Propriétés

Numéro d'article: 815179 - Dernière mise à jour: dimanche 13 mai 2007 - Version: 1.9
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft ASP.NET 1.0
  • Microsoft ASP.NET 1.1
Mots-clés : 
kbconfig kbweb kbhowtomaster KB815179
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com