Partilhar via


Atributos Geral herdados por elementos de seção

ASP.NET aplica as configurações aos recursos de forma hierárquica. As configurações são herdadas do pai arquivos de configuração. Este tópico lista vários atributos Geral que são herdados por todos os elementos de seção.

Elementos de seção

Elementos de seção são membros de seções de configuração. Isso não inclui elementos que são membros de grupos da seção de configuração.

Declarações de seção de configuração aparecem na parte superior do arquivo de configuração dentro de configSections elemento. Cada declaração contida em um seção elemento Especifica o nome de uma seção e o nome da classe .NET estrutura (derivado de ConfigurationSection) que processa dados de configuração nesta seção. seção Rótulos podem ser agrupadas em sectionGroup Rótulos.

Para obter mais informações, consulte Arquivos de configuração ASP.NET ou Editando Arquivos de Configuração ASP.NET.

Atributos Geral

A tabela a seguir descreve os atributos Geral que podem ser definidos para qualquer elemento de seção. Esses atributos Geral também são herdados por elementos filho dos elementos de seção. Todos os atributos cujos nomes incluem o trabalho lock são criados para proteger o conteúdo especificado no arquivo de configuração seja alterada. Nenhum elemento ou atributo está bloqueado por padrão.

Atributo

Descrição

configSource

Opcional String atributo.

Especifica o nome do arquivo de inclusão no qual a seção de configuração associada é definida, se esse arquivo existir. Programaticamente acessíveis por meio de ConfigSource propriedade.

Quando você usa o configSource atributo, você deverá mover a seção inteira para um arquivo separado porque não há nenhum mesclagem das configurações do elemento. Qualquer alterar feita no arquivo externo faz com que o aplicativo seja reiniciado por padrão. Para alterar esse comportamento para que o aplicativo não reinicia após cada alteração, você pode configurar o Elemento de seção para configSections (Geral Settings esquema) no arquivo Web.config e conjunto seu restartOnExternalChanges atributo à false.

lockAllAttributesExcept

Opcional String atributo; valor pode ser uma lista delimitada por vírgulas.

Bloqueia todos os atributos do elemento pai, exceto as especificadas.

Programaticamente acessíveis por meio de LockAllAttributesExcept propriedade.

Níveis mais baixos de hierarquia de configuração nunca podem bloquear os níveis que estão acima na hierarquia.

lockAllElementsExcept

Opcional String atributo; valor pode ser uma lista delimitada por vírgulas.

Bloqueia todos os elementos filho do elemento pai, exceto as especificadas.

Programaticamente acessíveis por meio de LockAllElementsExcept propriedade.

lockAttributes

Opcional String atributo; valor pode ser uma lista delimitada por vírgulas.

Bloqueia todos os atributos do elemento pai.

Programaticamente acessíveis por meio de LockAttributes propriedade.

lockElements

Opcional String atributo; valor pode ser uma lista delimitada por vírgulas.

Bloqueia todos os elementos filho do elemento pai.

Programaticamente acessíveis por meio de LockElements propriedade.

lockItem

Opcional String atributo.

true Se o elemento em que ocorre o atributo deve estar bloqueado; caso contrário, false. O padrão é false.

Esse atributo, além do que está sendo usado para bloquear qualquer elemento individual, também pode ser usado em elementos de coleção para bloqueá-los especificamente dentro de uma coleção especificada. Além disso, o atributo pode ser usado para bloquear qualquer seção inteira.

Programaticamente acessíveis por meio de LockItem propriedade.

Exemplo

O exemplo de código a seguir é uma parte do arquivo computador.config. Manipuladores de seção de configuração são declaradas para o system.web agrupar de seção e o anonymousIdentification seção. Abaixo disso, a sistema.Web and anonymousIdentification elementos de configuração são declarados.

The sistema.Web elemento de configuração é um membro de um agrupar de seção de configuração, que significa que ele não contém nenhum atributo.

The anonymousIdentification elemento de configuração é um membro de uma seção de configuração; portanto, ela herda os atributos listados na tabela anterior. Observe que o configSource o atributo tem um arquivo externo atribuído a ele (para conter o conteúdo do elemento) e que o lockItem atributo é definido como true Para evitar alterações em seu conteúdo.

<configuration>

  <configSections>
    <!-- Other configuration sections. -->
    <sectionGroup name="system.web" ...>
      <section name="anonymousIdentification" ... />
    </sectionGroup>
  </configSections>

  <system.web>
    <anonymousIdentification  configSource="IDSourceFile.xml" 
       lockItem="true" />
  </system.web>

</configuration>

Consulte também

Tarefas

Como: Bloquear ASP.NET Configuration Settings

Conceitos

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

Cenários de configuração ASP.NET

Protegendo configuração ASP.NET

Editando Arquivos de Configuração ASP.NET

Outros recursos

Arquivos de configuração ASP.NET