location, élément (Schéma des paramètres ASP.NET)
[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]
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é du .NET Framework version 2.0.
<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 <location> Settings et Locking Configuration Settings.
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
How to: Lock ASP.NET Configuration Settings
How to: Configure Specific Folders Using Location Settings
Référence
configuration, élément (Schéma des paramètres généraux)
Concepts
ASP.NET Configuration Overview
Locking Configuration Settings
Configuration <location> Settings