Desmarque elemento configSections (Geral Configurações Schema)

  • Artigo

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

<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 necessários em cada arquivo de configuração que é usado pelo common language runtime e a.Aplicativos do NET Framework.

configSections

Especifica as declarações de namespace e de seção 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

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

Se um arquivo de configuração tenta usar uma seção de configuração após a referência do manipulador é removida, ASP.NET emite o erro de servidor "não reconhecido a seção de configuração 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 limpar as seções que foram previamente definidas no arquivo Machine. config.

O código de um arquivo Machine. config a seguir 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 de um arquivo de configuração do aplicativo a seguir limpa todas as seções declaradas anteriormente. O aplicativo não pode usar ou recuperar as configurações em uma das seções que foram declaradas no arquivo Machine. config. 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 da seção de configuração

Não se aplica.

Membro de configuração

Clear()

Clear()

Locais configuráveis

Machine.config

Web. config de nível de raiz

Web. config de nível de aplicativo

Virtual ou física directory–level Web. config

Requisitos

De da (IIS) versão 5.0, 5.1 ou 6.0

A.NET Framework versão 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Referência

configSections Element (Geral Configurações Schema)

sectionGroup elemento para configSections (Geral Configurações Schema)

seção elemento de configSections (Geral Configurações Schema)

remover o elemento configSections (Geral Configurações Schema)

configuração Element (Geral Configurações Schema)

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

Outros recursos

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Arquivos de configuração ASP.NET

Administração de Sites do ASP.NET

API de Configuração do ASP.NET