Partilhar via


local elemento (ASP.NET Settings esquema)

Especifica o recurso configurações que filho aplicar para 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.

configuração elemento (Geral Settings esquema)
  local elemento (ASP.NET Settings esquema)

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

Atributos e elementos

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

Atributos

Atributo

Descrição

allowOverride

Opcional Boolean atributo.

Especifica se configuração configurações podem ser substituídas pelas configuração configurações que estão nos arquivos Web.config em diretórios filho.

O padrão é True.

path

Opcional String atributo.

Especifica o recurso que as definições de configuração contidos aplicar para. Usando location com um ausente path atributo se aplica a configuração configurações para o diretório corrente e todos os diretórios filhos. If location é usado com nenhum path atributo e allowOverride é False, configuração configurações não podem ser alteradas pelos arquivos Web.config em diretórios filho.

Elementos filho

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

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.

Comentários

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

The location elemento pode colocar outros elementos, para aplicar definições de configuração 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 logon.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 conjunto o limite de dimensionar 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 que as configurações sejam alteradas pelos arquivos Web.config em diretórios filho.

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

Informações do elemento

Manipulador de seção de configuração

Não se aplica.

Configuração de membro

ConfigurationLocation

Locais configuráveis

Machine.config

Web.config de nível de raiz

Web.config de nível de aplicativo

Virtual ou físico diretório–nível Web.config

Requisitos

Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0

O .NET estrutura versão 2.0

Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Tarefas

Como: Bloquear ASP.NET Configuration Settings

Como: Configurar diretórios específicos usando configurações de local

Conceitos

Visão Geral da Configuração ASP.NET

Protegendo configuração ASP.NET

Bloqueando Definições de Configuração

Configurando arquivos específicos e subpastas

Referência

configuração elemento (Geral Settings esquema)

ConfigurationLocation

Outros recursos

Definições de configuração ASP.NET