Compartilhar via

desmarcar elemento configSections (Geral Settings esquema)

  • Artigo

Remove todas as referências a herdadas de seções e grupos de seções, permitindo que apenas as seções e grupos de seções que são adicionados pelo corrente seção and sectionGroup elementos.

configuração elemento (Geral Settings esquema)
  configSections elemento (Geral Settings esquema)
    desmarcar elemento configSections (Geral Settings esquema)
      configuração elemento (Geral Settings esquema)
        configSections elemento (Geral Settings esquema)
          sectionGroup elemento para configSections (Geral Settings esquema)
            desmarcar elemento configSections (Geral Settings esquema)

<clear />

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Nenhum.

Elementos filho

Nenhum.

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.

configSections

Especifica o espaço para nome e a seção declarações de configuração.

sectionGroup

Define uma associação entre um manipulador de seção de configuração e uma seção de configuração.

Comentários

The clear elemento remove todas as referências para herdadas de seções e grupos de seções, permitindo que apenas as seções e grupos de seções que são adicionados pelo corrente seção and sectionGroup elementos.

Se um arquivo de configuração tenta usar uma seção de configuração após o manipulador de referência é removida, ASP.NET emitirá o erro de servidor, seção de configuração desconhecido"element_name."

Exemplo

O exemplo de código a seguir mostra como usar o clear elemento em um arquivo de configuração do aplicativo para desmarcar seções que foram definidas anteriormente no arquivo computador.config.

O código a seguir de um arquivo computador.config declara duas seções, sampleSection e anotherSampleSection, que são lidos antes do arquivo de configuração do aplicativo.

<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
      <section name="anotherSampleSection"
               type="System.Configuration.NameValueSectionHandler" />
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

O código a seguir de um arquivo de configuração do aplicativo limpa todas as seções declaradas anteriormente. O aplicativo não é possível usar ou recuperar as configurações de uma das seções que foram declaradas no the computador. arquivo de configuração. No entanto, o aplicativo pode usar as configurações de anotherSection porque anotherSection Após o clear elemento.

<configuration>

<configSections>

<clear/>

<section name="anotherSection"

type="System.Configuration.NameValueSectionHandler" />

</configSections>

</configuration>

Informações do elemento

Manipulador de seção de configuração

Não se aplica.

Configuração de membro

Clear()

Clear()

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 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Conceitos

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Editando Arquivos de Configuração ASP.NET

Cenários de configuração ASP.NET

Referência

configSections elemento (Geral Settings esquema)

sectionGroup elemento para configSections (Geral Settings esquema)

Elemento de seção para configSections (Geral Settings esquema)

Remover elemento configSections (Geral Settings esquema)

configuração elemento (Geral Settings esquema)

Outros recursos

Configurações gerais (ASP.NET)

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

Arquivos de configuração ASP.NET

Administrando ites da Web do ASP.NET

API de Configuração do ASP.NET