Modifier la configuration d’une application ASP.NET

Cet article explique comment modifier le fichier Web.config d’une application ASP.NET.

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

Résumé

Le fichier Web.config définit le comportement des applications ASP.NET. Microsoft .NET Framework, y compris ASP.NET, utilise des fichiers texte .config au format XML pour configurer des applications. Il s’agit d’un écart par rapport aux mécanismes de configuration de registre et de métabase conventionnels. Actuellement, il n’existe aucun composant logiciel enfichable MMC (Microsoft Management Console) ou tout autre outil d’administration fourni par Microsoft pour la création et la modification des fichiers .config.

Ajouter des paramètres de configuration à Web.config

La plupart des applications ASP.NET sont fournies avec un fichier Web.config prédéfini qui peut être modifié avec n’importe quel éditeur de texte tel que le Bloc-notes. En règle générale, les fichiers Web.config contiennent des commentaires qui modifient le fichier de manière explicite. Toutefois, vous devrez peut-être ajouter des éléments de configuration à un fichier Web.config qui n’a pas encore défini l’élément de configuration. 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 %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ répertoire.

  2. Dans le fichier Machine.config , recherchez le paramètre de configuration à remplacer dans votre fichier Web.config . Lorsque l’élément est plusieurs lignes, l’élément commence par une <element_name> ligne et se termine par </element_name>. L’élément peut également être auto-fermant et peut ressembler à <element_name attribute1='option' attribute2='option' />. 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 --> les marquages. L’exemple <trace> d’élément de configuration suivant est un exemple d’élément auto-fermant. L’exemple <trace> d’élément de configuration comporte plusieurs attributs, s’étend sur plusieurs lignes et comporte un commentaire au début.

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output 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. Copiez l’élément de configuration entier et tout commentaire de début dans le Presse-papiers.

  4. Déterminez comment l’élément est imbriqué dans le fichier Machine.config .

    Le fichier Machine.config est hiérarchique et les éléments de configuration sont imbriqués dans d’autres éléments. Lorsque vous copiez un élément de configuration du fichier Machine.config dans le fichier Web.config , vous devez imbriquer cet élément de configuration dans le même élément qu’il a été copié. Pour déterminer l’élément du fichier Machine.config dans lequel l’élément de configuration est contenu, faites défiler vers le haut dans le fichier Machine.config jusqu’à ce que vous trouviez un élément ouvert, non fermé. L’élément conteneur est simple à identifier, car les éléments de niveau supérieur ont moins de retrait.

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

    Note

    Élément dans lequel votre élément de configuration est contenu. Vous devez coller cet élément dans le même élément 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érieur dans le fichier Web.config .

  5. Fermez le fichier Machine.config , puis utilisez votre éditeur de texte pour ouvrir le fichier Web.config dans le répertoire racine de votre application ASP.NET.

  6. Collez l’élément de configuration entre le début et la fin de l’élément que vous avez identifié à l’étape 4.

    Par exemple, si l’élément de configuration est contenu dans l’élément <system.web> , l’élément de configuration doit être collé immédiatement après la ligne d’ouverture de l’élément <system.web> et avant la </system.web> ligne fermante.

  7. Modifiez 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 les sous-dossiers.

References

  • Last updated on