Elemento location (schema delle impostazioni ASP.NET)

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 Configurazione di sottodirectory e file specifici e Blocco delle impostazioni di configurazione.

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à

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Procedura: configurare directory specifiche utilizzando impostazioni di percorso

Riferimenti

Elemento configuration (schema delle impostazioni generali)

ConfigurationLocation

Concetti

Cenni preliminari sulla configurazione di ASP.NET

Protezione della configurazione di ASP.NET

Blocco delle impostazioni di configurazione

Configurazione di sottodirectory e file specifici

Altre risorse

Impostazioni di configurazione di ASP.NET