Elemento location (schema delle impostazioni ASP.NET)
[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]
Specifica la risorsa a cui vengono applicate le impostazioni di configurazione figlio e blocca le impostazioni di configurazione, impedendone l'override da parte dei file di configurazione figlio.
Questo elemento è nuovo in .NET Framework versione 2.0.
<location
allowOverride="true|false"
path="path"
/>
Attributi ed elementi
Le seguenti sezioni illustrano attributi, elementi figlio e padre per questo elemento.
Attributi
Attributo |
Descrizione |
|---|---|
allowOverride |
Attributo Boolean facoltativo. Specifica se è possibile eseguire l'override delle impostazioni di configurazione con quelle incluse nei file Web.config delle directory figlio. Il valore predefinito è true.. |
path |
Attributo String facoltativo. Specifica la risorsa a cui vengono applicate le impostazioni di configurazione contenute. Se si utilizza location senza un attributo path, le impostazioni di configurazione vengono applicate alla directory corrente e a tutte le directory figlio. Se location viene utilizzato senza alcun attributo path e allowOverride è impostato su false, le impostazioni di configurazione non possono essere modificate dai file Web.config nelle directory figlio. |
inheritInChildApplications |
Attributo Boolean facoltativo. Specifica se le impostazioni di configurazione specifiche di una determinata posizione, ad esempio la directory radice di un sito Web, vengano ereditate da applicazioni presenti nelle sottodirectory. Il valore predefinito è true.. |
Elementi figlio
L'elemento location può racchiudere altri elementi, per applicare le impostazioni di configurazione a una risorsa specifica o per bloccarle.
Elementi padre
Elemento |
Descrizione |
|---|---|
configuration |
Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework. |
Note
L'elemento location specifica la risorsa a cui vengono applicate le impostazioni di configurazione figlio e blocca le impostazioni di configurazione, impedendone l'override da parte dei file di configurazione figlio.
L'elemento location può racchiudere altri elementi, per applicare le impostazioni di configurazione a una risorsa specifica o per bloccarle. Per ulteriori informazioni, vedere Configuration <location> Settings e Locking Configuration Settings.
Esempio
Nell'esempio di codice riportato di seguito viene illustrato come consentire l'accesso da parte di un utente anonimo alla pagina Logon.aspx
<configuration>
<location path="Logon.aspx">
<system.web>
<authorization>
<allow users="?"/>
</authorization>
</system.web>
</location>
</configuration>
Nell'esempio di codice riportato di seguito viene illustrato come impostare il limite di dimensione del file caricato su 128 KB solo per la pagina specificata.
<configuration>
<location path="UploadPage.aspx">
<system.web>
<httpRuntime maxRequestLength="128"/>
</system.web>
</location>
</configuration>
Nell'esempio di codice riportato di seguito viene illustrato come impedire la modifica delle impostazioni di configurazione da parte dei file Web.config nelle directory figlio.
<configuration>
<location allowOverride="false"/>
</configuration>
Informazioni sull'elemento
Gestore della sezione di configurazione |
Non applicabile. |
Membro di configurazione |
|
Percorsi configurabili |
Machine.config Web.config a livello di radice Web.config a livello di applicazione Web.config a livello di directory fisica o virtuale |
Requisiti |
Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 .NET Framework versione 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005 |
Vedere anche
Attività
How to: Lock ASP.NET Configuration Settings
How to: Configure Specific Folders Using Location Settings
Riferimenti
Elemento configuration (schema delle impostazioni generali)
Concetti
ASP.NET Configuration Overview
Locking Configuration Settings
Configuration <location> Settings