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