Comment faire pour modifier la configuration d'une application ASP.NET

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

Sommaire

Résumé

Cet article étape par étape décrit comment créer et comment modifier le fichier Web.config. Le fichier Web.config définit le comportement d'ASP.NET applications. Le .NET Framework, y compris ASP.NET, utilise fichiers texte .config au format XML pour configurer des applications. C'est un départ de mécanismes de configuration Registre et la métabase conventionnelles. Il y a actuellement aucun composant logiciel enfichable MMC (Microsoft Management Console) ou autre outil d'administration fournis par Microsoft pour créer et modifier des fichiers .config.



Ajouter des paramètres de configuration au fichier Web.config

La plupart des applications ASP.NET sont fournis avec un fichier Web.config prédéfinie qui peut être modifié avec n'importe quel éditeur de texte tel que le bloc-notes. En règle générale, Web.config fichiers contiennent des commentaires qui facilitent la modification du fichier explicite. Toutefois, vous devez ajouter des éléments de configuration à un fichier Web.config qui ne comporte pas encore la configuration de l'article définie. Pour ajouter un élément de configuration standard à un fichier Web.config, procédez comme suit :
  1. Ouvrez le fichier machine.config dans un éditeur de texte tel que le bloc-notes.

    Le fichier machine.config se trouve dans le répertoire %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\.
  2. Dans le fichier machine.config, recherchez le paramètre de configuration de que votre choix pour remplacer dans votre fichier Web.config. Lorsque l'élément est plusieurs lignes, l'élément commence par un <element_name>ligne et se termine par </element_name>. L'élément peut également être self-closing et peut être semblable au <element_name attribute1=?option? attribute2=?option? />. Notez que l'espace blanc est ignoré. Par conséquent, l'élément peut s'étendre sur plusieurs lignes. L'élément peut être précédé d'un commentaire. Le commentaire est contenu dans <!-- and -->marquages. Le <trace>exemple d'élément de configuration qui suit est un exemple d'un élément self-closing. Le <trace>exemple d'élément de configuration a plusieurs attributs, s'étend sur plusieurs lignes et a un commentaire à début.
    <!--
    trace Attributes:
        enabled="[true|false]" - Enable application tracing
        localOnly="[true|false]" - View trace results from localhost only
        pageOutput="[true|false]" - Display trace ouput on individual pages
        requestLimit="[number]" - Number of trace results available in trace.axd
        traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
      -->
    <trace
        enabled="false"
        localOnly="true"
        pageOutput="false"
        requestLimit="10"
        traceMode="SortByTime"
    />
  3. Copie l'élément configuration entière et tout début commentaire dans le Presse-papiers.
  4. Déterminer comment l'élément est imbriqué dans machine.config le fichier.

    Le fichier machine.config est hiérarchique et éléments de configuration sont imbriqués dans des autres éléments. Lorsque vous copiez un élément de configuration à partir du fichier Machine.config dans le fichier Web.config, vous devez imbriquer cet élément de configuration dans le même élément il avait été copié à partir de. Pour déterminer l'élément du fichier Machine.config contenues dans l'élément de configuration, faites défiler jusqu'à dans le fichier machine.config jusqu'à ce que vous trouviez un élément est ouvert, ne pas fermé. L'élément contenant est facile à identifier, car éléments de niveau supérieurs ont moins retrait.

    ASP.NET la plupart des éléments de configuration sont contenus dans le <system.web>élément. La fin de l'élément ( </system.web>) doit être placée après votre élément de configuration.

    Notez l'élément contenu dans l'élément de configuration. Vous devez coller cet élément dans l'élément même dans le fichier Web.config. Un élément de configuration peut être imbriqué dans plusieurs éléments. Vous devez créer tous les éléments de niveau supérieurs dans le fichier Web.config.
  5. Fermez le fichier machine.config et utiliser l'éditeur de texte pour ouvrir le fichier Web.config dans le répertoire racine de ASP.NET votre application.
  6. Collez l'élément de configuration entre le début et la fin de l'élément que vous avez identifié dans l'étape 4.

    Par exemple, si l'élément de configuration se trouve dans le <system.web>élément, l'élément de configuration doit être collé immédiatement après la ligne l'ouverture de la <system.web>élément et avant le </system.web>la fermeture de ligne.
  7. Modifier l'élément de configuration dans le fichier Web.config pour remplacer le paramètre machine.config pour cette application.

    Ce paramètre s'applique au dossier qui contient le fichier Web.config et tous ses sous-dossiers.


Références

Pour plus d'informations, cliquez sur les numéros ci-dessous pour afficher les articles correspondants dans la Base de connaissances Microsoft :
815179 Comment faire pour créer le fichier Web.config pour une application ASP.NET
818016 Comment faire pour déployer des applications qui sont créées sur .NET Framework
Pour plus d'informations configuration ASP.NET et le format des fichiers de configuration ASP.NET, consultez la documentation du Kit de développement .NET Framework SDK ou reportez-vous aux sites Web de Microsoft aux adresses suivantes :

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

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

Propriétés

Numéro d'article: 815178 - Dernière mise à jour: dimanche 13 mai 2007 - Version: 1.10
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 : 
kbmt kbweb kbconfig kbredistribution kbdeployment kbhowtomaster KB815178 KbMtfr
Traduction automatique
IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d?avoir accès, dans votre propre langue, à l?ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s?exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s?efforce aussi continuellement de faire évoluer son système de traduction automatique.
La version anglaise de cet article est la suivante: 815178
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