Partilhar via


Geral Atributos Herdados por elementos de seção

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

Elementos de seção

Elementos de seção são membros das seções de configuração. Isso não inclui elementos que são membros dos grupos de 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 instrução contida em um seção elemento Especifica o nome de uma seção e o nome da.Classe do NET Framework (derivado de ConfigurationSection) que processa os dados de configuração na seção. seção marcas podem ser agrupadas em sectionGroup marcas.

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

Atributos gerais

A tabela a seguir descreve os atributos gerais que podem ser definidos para quaisquer elementos de seção. Esses atributos gerais também são herdados pelos elementos do filho dos elementos de seção. Todos os atributos cujos nomes incluem o trabalho lock são projetados 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 tal arquivo existir. Programaticamente acessível através de ConfigSource propriedade.

Quando você usa o configSource atributo, você deve mover toda a seção em um arquivo separado porque não há nenhum mesclagem das configurações do elemento. Qualquer alteração ao 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 seção elemento de configSections (Geral Configurações Schema) na Web. config arquivo e defina seu restartOnExternalChanges atributo para false.

lockAllAttributesExcept

Opcional String atributo; o valor pode ser uma lista delimitada por ponto-e-vírgula.

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

Programaticamente acessível através de LockAllAttributesExcept propriedade.

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

lockAllElementsExcept

Opcional String atributo; o valor pode ser uma lista delimitada por ponto-e-vírgula.

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

Programaticamente acessível através de LockAllElementsExcept propriedade.

lockAttributes

Opcional String atributo; o valor pode ser uma lista delimitada por ponto-e-vírgula.

Bloqueia todos os atributos do elemento pai.

Programaticamente acessível através de LockAttributes propriedade.

lockElements

Opcional String atributo; o valor pode ser uma lista delimitada por ponto-e-vírgula.

Bloqueia todos os elementos filho do elemento pai.

Programaticamente acessível através de LockElements propriedade.

lockItem

Opcional String atributo.

trueSe o elemento no qual o atributo ocorre deve ser 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ível através de LockItem propriedade.

Exemplo

O exemplo de código a seguir é uma parte do arquivo Machine. config. Os manipuladores de seção de configuração são declarados para o system.web o grupo de seção e a anonymousIdentification seção. Abaixo disso, o sistema de.Web e anonymousIdentification elementos de configuração são declarados.

O sistema de.Web o elemento de configuração é um membro de um grupo de seção de configuração, o que significa que ele não contém quaisquer atributos.

O anonymousIdentification o elemento de configuração é um membro de uma seção de configuração; Portanto, ela herda os atributos listados na tabela anterior. Observe que seu configSource atributo tem um arquivo externo, atribuído a ele (para conter o conteúdo do elemento) e que o lockItem atributo está 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 definições de configuração ASP.NET

Conceitos

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

Cenários de configuração ASP.NET

Protegendo a configuração do ASP.NET

Editando Arquivos de Configuração ASP.NET

Outros recursos

Arquivos de configuração ASP.NET