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

<location>

Réduire tout

Filtre de langue

This page is specific to

Microsoft Visual Studio 2005/.NET Framework 2.0

Other versions are also available for the following:

Référence générale du .NET Framework

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.

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

<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.

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.

Éléments enfants

É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">
      <httpRuntime maxRequestLength="128"/>
   </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