local Element (ASP.NET Settings Schema)
[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]
Especifica o recurso que filhoconfiguração configurações aplicar a e as definições de configuração de bloqueios, impedindo que as configurações seja substituído por arquivos deconfiguração do filho.
Este elemento é novo na.NET Framework versão 2.0.
<location
allowOverride="true|false"
path="path"
/>
Attributes and Elements
As seções a seguir descrevem os atributos, elementos filho e elementos pai para esse elemento.
Attributes
Atributo |
Descrição |
|---|---|
allowOverride |
Opcional Boolean atributo. Especifica se as definições de configuração podem ser substituídas pelas configurações de configuração que estão na Web. config arquivos que estão em diretórios filho . O padrão étrue. |
path |
Opcional String atributo. Especifica o recurso que o contido configuração configurações aplicar a. Usando location com um ausente path atributo aplica configuração para o diretório atual e todos os diretórios filho . Se location é usado com nenhum path atributo e allowOverride é false, as configuração não podem ser alteradas pelos arquivos Web. config são diretórios filho . |
inheritInChildApplications |
Opcional Boolean atributo. Especifica se as definições de configuração que são específicas para um determinado local (como, por exemplo, o diretório raiz de um site Web ) são herdadas pelos aplicativos que existem nos subdiretórios. O padrão étrue. |
Child Elements
O location elemento pode colocar outros elementos, para aplicardefinições deconfiguração para um determinado recurso ou para bloquear as definições de configuração .
Parent Elements
Elemento |
Descrição |
|---|---|
configuration |
Especifica o elemento raiz de necessários em cada arquivo de configuração que é usado pelo Common Language Runtime e o.NET Framework applications. |
Remarks
O location Especifica o recurso que filhoconfiguração configurações aplicar a e também é usado para definições deconfiguração de bloquear, impedindo que as configurações seja substituído por arquivos deconfiguração do filhodo elemento.
O location elemento pode colocar outros elementos, para aplicardefinições deconfiguração para um determinado recurso ou para bloquear as configurações. Para obter mais informações, consulte Configuration <location> Settings e Locking Configuration Settings.
Exemplo
O exemplo de código a seguir demonstra como permitir que um usuário anônimo acessar a página aspx.
<configuration>
<location path="Logon.aspx">
<system.web>
<authorization>
<allow users="?"/>
</authorization>
</system.web>
</location>
</configuration>
O exemplo de código a seguir demonstra como definir o limite de tamanho do arquivo de carregado para 128 KB para somente a página especificada.
<configuration>
<location path="UploadPage.aspx">
<system.web>
<httpRuntime maxRequestLength="128"/>
</system.web>
</location>
</configuration>
O exemplo de código a seguir demonstra como impedir que as configuração sejam alteradas pelos arquivos do Web. config que estão em diretórios filho .
<configuration>
<location allowOverride="false"/>
</configuration>
Element Information
Manipulador da seção de configuração |
Faz com que não aplicar. |
Membro de configuração |
|
Locais configuráveis |
Machine.config . Config da Webde nível de raiz . Config do nível de aplicativo Web . Config do Webdirectory–level virtual ou física |
Requisitos |
Serviços de Informações da Internet da Microsoft Internet (IIS) versão 5.0, 5.1 ou 6.0 A.NET Framework versão 2.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005 |
Consulte também
Tasks
How to: Lock ASP.NET Configuration Settings
How to: Configure Specific Folders Using Location Settings
Reference
configuração Element (General Settings Schema)
Concepts
ASP.NET Configuration Overview
Locking Configuration Settings
Configuration <location> Settings