local de elemento (ASP.NET Configurações Schema)

Especifica o recurso que filho configurações se aplicam e bloqueia as definições de configuração, impedindo que as configurações que estão sendo substituídos por arquivos de configuração do filho.

Esse elemento é novo no .NET Framework versão 2.0.

<location 
   allowOverride="True|False"
   path="path" 
/>

Atributos e elementos

As seções a seguir descrevem os atributos, elementos filho e os elementos pai para esse elemento.

Atributos

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 em arquivos Web. config em diretórios filho. O padrão éTrue.
path	Opcional String atributo. Especifica que as definições de configuração contidos se aplicam ao recurso. Usando location com um ausente path atributo se aplica as configurações para o diretório atual e todos os diretórios filho. Se location é usado com nenhum path atributo e allowOverride é False, as configurações não podem ser alteradas pelos arquivos Web. config, que estão em diretórios de 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 da Web) são herdadas pelos aplicativos que existem nos subdiretórios. O padrão éTrue.

Elementos filho

O location elemento pode colocar outros elementos, ou aplicar configurações a um recurso específico ou para bloquear as configurações de configuração.

Elementos pai

Elemento	Descrição
configuration	Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.Aplicativos do NET Framework.

Comentários

O location elemento Especifica o recurso que se aplicam a definições de configuração do filho e também é usado para bloquear as definições de configuração, impedindo que as configurações que está sendo substituído por arquivos de configuração do filho.

O location elemento pode colocar outros elementos, ou aplicar configurações a um recurso específico ou para bloquear as configurações. Para obter mais informações, consulte Configurando arquivos específicos e subpastas e Bloqueando Definições de Configuração.

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 carregado para 128 KB para 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 as configurações sejam alteradas pelos arquivos Web. config em diretórios filho.

<configuration>
   <location allowOverride="false"/>
</configuration>

Informações do elemento

Manipulador da seção de configuração	Não se aplica.
Membro de configuração	ConfigurationLocation
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Virtual ou física directory–level Web. config
Requisitos	De da (IIS) versão 5.0, 5.1 ou 6.0 A.NET Framework versão 2.0 Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Tarefas

Como: Bloquear definições de configuração ASP.NET

Como: Configurar Diretórios Específicos Usando Configurações por Localização

Referência

configuração Element (Geral Configurações Schema)

ConfigurationLocation

Conceitos

Visão geral da configuração ASP.NET

Protegendo a configuração do ASP.NET

Bloqueando Definições de Configuração

Configurando arquivos específicos e subpastas

Outros recursos

ASP.NET Configuration Settings