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

ConfigurationLocation

Concetti

ASP.NET Configuration Overview

Securing Configuration

Locking Configuration Settings

Configuration <location> Settings

Altre risorse

Impostazioni di configurazione di ASP.NET