Modifier la configuration d’une application ASP.NET

  • Article

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

              Version d’origine du produit : ASP.NET
Numéro de la 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 classiques du registre et de la métabase. Actuellement, il n’existe aucun composant logiciel enfichable MMC (Microsoft Management Console) ou un autre outil d’administration fourni par Microsoft pour créer et modifier .config fichiers.

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, Web.config fichiers contiennent des commentaires qui rendent la modification du fichier explicite. Toutefois, vous devrez peut-être ajouter des éléments de configuration à un fichier Web.config pour lequel l’élément de configuration n’est pas déjà défini. 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 que vous souhaitez remplacer dans votre fichier Web.config . Lorsque l’élément a plusieurs lignes, l’élément commence par une <element_name> ligne et se termine par </element_name>. L’élément peut également se fermer automatiquement et peut ressembler à <element_name attribute1='option' attribute2='option' />. Les espaces sont ignorés. 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 --> des marquages. L’exemple <trace> d’élément de configuration qui suit est un exemple d’élément à fermeture automatique. L’exemple <trace> d’élément de configuration a plusieurs attributs, s’étend sur plusieurs lignes et contient 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’ensemble de l’élément de configuration 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 vers le fichier Web.config , vous devez imbriquer cet élément de configuration dans le même élément que celui à partir duquel 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 le fichier Machine.config jusqu’à ce que vous trouviez un élément qui est ouvert et 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.

    Remarque

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

  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