Partager via


location, élément (Schéma des paramètres ASP.NET)

Spécifie la ressource à laquelle les paramètres de configuration enfants s'appliquent et verrouille des paramètres de configuration, empêchant la substitution des paramètres par les fichiers de configuration enfants.

Cet élément est une nouveauté de la version 2.0 du .NET Framework.

<location 
   allowOverride="True|False"
   path="path" 
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents pour cet élément.

Attributs

Attribut

Description

allowOverride

Attribut Boolean facultatif.

Spécifie si les paramètres de configuration peuvent être substitués par les paramètres de configuration présents dans les fichiers Web.config des répertoires enfants.

La valeur par défaut est True.

path

Attribut String facultatif.

Spécifie la ressource à laquelle s'appliquent les paramètres de configuration présents dans l'élément. Si vous utilisez location avec un attribut path manquant, les paramètres de configuration sont appliqués au répertoire actif et à tous les répertoires enfants. Si location est utilisé sans attribut path et si allowOverride a la valeur False, les paramètres de configuration ne peuvent pas être modifiés par les fichiers Web.config figurant dans les répertoires enfants.

inheritInChildApplications

Attribut Boolean facultatif.

Spécifie si les paramètres de configuration qui sont spécifiques à un certain emplacement (tel que le dossier racine d'un site Web) sont hérités par les applications qui se trouvent dans les sous-répertoires.

La valeur par défaut est True.

Éléments enfants

L'élément location peut comprendre d'autres éléments, soit pour appliquer des paramètres de configuration à une ressource spécifique, soit pour verrouiller les paramètres de configuration.

Éléments parents

Élément

Description

configuration

Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

Notes

L'élément location spécifie la ressource à laquelle les paramètres de configuration enfants s'appliquent et permet également de verrouiller des paramètres de configuration, empêchant ainsi la substitution des paramètres par les fichiers de configuration enfants.

L'élément location peut comprendre d'autres éléments, soit pour appliquer des paramètres de configuration à une ressource spécifique, soit pour verrouiller les paramètres. Pour plus d'informations, consultez Configuration de fichiers et de sous-répertoires spécifiques et Verrouillage des paramètres de configuration.

Exemple

L'exemple de code suivant montre comment autoriser un utilisateur anonyme à accéder à la page Logon.aspx.

<configuration>
   <location path="Logon.aspx">
      <system.web>
         <authorization>
            <allow users="?"/>
         </authorization>
      </system.web>
   </location>
</configuration>

L'exemple de code suivant montre comment définir la limite de taille de fichier téléchargé avec une valeur de 128 Ko uniquement pour la page spécifiée.

<configuration>
  <location path="UploadPage.aspx">
    <system.web>
      <httpRuntime maxRequestLength="128"/>
    </system.web>
  </location>
</configuration>

L'exemple de code suivant montre comment empêcher la modification des paramètres de configuration par les fichiers Web.config présents dans les répertoires enfants.

<configuration>
   <location allowOverride="false"/>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration

Non applicable.

Membre de configuration

ConfigurationLocation

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Web.config de niveau répertoire virtuel ou physique

Configuration requise

Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0

.NET Framework version 2.0

Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Tâches

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

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

Référence

configuration, élément (Schéma des paramètres généraux)

ConfigurationLocation

Concepts

Vue d'ensemble de la configuration ASP.NET

Sécurisation de la configuration ASP.NET

Verrouillage des paramètres de configuration

Configuration de fichiers et de sous-répertoires spécifiques

Autres ressources

Paramètres de configuration ASP.NET