Atributos gerais, herdada por elementos de seção

[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.]

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 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 do configSections elemento. Cada instrução contida em um seção elemento Especifica o nome de uma seção e o nome da.NET Framework "crua" (derivado de ConfigurationSection) que processa os dados de configuração nesta seção. seção marcas podem ser agrupadas em sectionGroup marcas.

Para obter mais informações, consulte ASP.NET Configuration Files ou Format of ASP.NET Configuration Files.

Atributos gerais

A tabela a seguir descreve os atributos gerais que podem ser definidos para qualquer elemento de seção. Esses atributos gerais também são herdados pelos 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 incluir no qual a seção de configuração associada é definida, se tal arquivo existir. Programaticamente acessível através do 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 alteração 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 seção elemento de configSections (General Settings Schema) na Web. config arquivo e defina seu restartOnExternalChanges para o atributo false.
lockAllAttributesExcept	Opcional String de atributo; o valor pode ser uma lista delimitada por vírgulas. Bloqueia todos os atributos do elemento pai, exceto as especificadas. Programaticamente acessível através do 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 de atributo; o valor pode ser uma lista delimitada por vírgulas. Bloqueia todos os elementos filho do elemento pai, exceto as especificadas. Programaticamente acessível através do LockAllElementsExcept propriedade.
lockAttributes	Opcional String de atributo; o valor pode ser uma lista delimitada por vírgulas. Bloqueia todos os atributos do elemento pai. Programaticamente acessível através do LockAttributes propriedade.
lockElements	Opcional String de atributo; o valor pode ser uma lista delimitada por vírgulas. Bloqueia todos os elementos filho do elemento pai. Programaticamente acessível através do LockElements propriedade.
lockItem	Opcional String atributo. trueSe o elemento em que 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 do LockItem propriedade.

Exemplo

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

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

O 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 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

Tasks

How to: Lock ASP.NET Configuration Settings

Concepts

ASP.NET Configuration Overview

Configuration Inheritance

Securing Configuration

Format of ASP.NET Configuration Files

Other Resources

ASP.NET Configuration Files