Condividi tramite


Elemento location (schema delle impostazioni ASP.NET)

Aggiornamento: novembre 2007

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.

Elemento configuration (schema delle impostazioni generali)
  Elemento location (schema delle impostazioni ASP.NET)

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

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 le impostazioni posizione

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

Riferimenti

Elemento configuration (schema delle impostazioni generali)

ConfigurationLocation

Altre risorse

Impostazioni di configurazione di ASP.NET