Partager via


Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Mise à jour : novembre 2007

En utilisant l'élément location avec une valeur appropriée pour l'attribut path, vous pouvez appliquer des paramètres de configuration à des dossiers et fichiers spécifiques. L'attribut path peut être utilisé pour identifier un fichier ou un répertoire enfant spécifique auquel des paramètres de configuration uniques s'appliquent. Un seul chemin d'accès peut être utilisé dans l'attribut path. L'élément location est prioritaire sur n'importe quel paramètre de configuration ASP.NET du fichier Web.config actif.

Vous pouvez définir l'élément location par programme à l'aide de l'API de configuration ASP.NET ou le définir en utilisant l'onglet Emplacements dans le composant logiciel enfichable MMC ASP.NET.

La valeur par défaut de la propriété Path est ".". Plusieurs éléments location peuvent exister dans le même fichier de configuration, spécifiant des portées différentes pour les mêmes sections de configuration, comme l'illustre l'exemple suivant :

  <location path="." >
    <section1 … />
    <section2 … />
  </location>
  <location path="Default Web Site" >
    <section1 … />
    <section2 … />
  </location
  <location path="Default Web Site/foo/bar/xyz.html" >
    <section1 … />
    <section2 … />
  </location>

Exemple

L'exemple de code suivant illustre un fichier de configuration qui spécifie des paramètres pour deux ressources spécifiques :

  • Les paramètres qui s'appliquent uniquement au répertoire enfant Sub1 sont placés entre les balises <location> et </location>, avec un attribut path affecté de la valeur Sub1.

  • Les paramètres qui s'appliquent uniquement au répertoire enfant Sub2 sont placés entre les balises <location> et </location>, avec un attribut path affecté de la valeur Sub1.

Les paramètres qui s'appliquent au répertoire actif et à tous les répertoires enfants sont placés entre les balises <configuration> et </configuration>, mais ils ne sont pas entourés par des balises <location> et </location>.

<configuration>
  <system.web>
    <sessionState cookieless="true" timeout="10" />
  </system.web>

  <!-- Configuration for the "Sub1" subdirectory. -->
  <location path="sub1">
    <system.web>
      <httpHandlers>
        <add verb="*" path="Sub1.Scott" type="Sub1.Scott" />
        <add verb="*" path="Sub1.David" type="Sub1.David" />
      </httpHandlers>
    </system.web>
  </location>

  <!-- Configuration for the "Sub2" subdirectory. -->
  <location path="sub2">
    <system.web>
      <httpHandlers>
        <add verb="*" path="Sub2.Scott" type="Sub2.Scott" />
        <add verb="*" path="Sub2.David" type="Sub2.David" />
      </httpHandlers>
    </system.web>
  </location>
</configuration>

Voir aussi

Tâches

Comment : verrouiller des paramètres de configuration ASP.NET

Autres ressources

Composant logiciel enfichable MMC pour ASP.NET