Partilhar via


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

Remove uma referência a uma seção herdada e o grupo da seção.

<remove 
   name="section name" 
/>

Atributos e elementos

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

Atributos

Atributo

Descrição

name

Obrigatório String atributo.

Especifica o nome da seção ou grupo de seção para remover. Isso é igual a name atributo na seção ou sectionGroup elemento adicionado a referência.

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 remove elemento remove uma referência a um seções herdadas ou seção grupos. Novas seções e grupos de seções podem ser adicionados à coleção no arquivo de configuração atual usando o 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 remove elemento em um arquivo de configuração do aplicativo para remover uma seção que foi definida anteriormente no arquivo Machine. config.

O código de arquivo de Machine. config a seguir declara uma seção chamada sampleSection.

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

O arquivo de configuração de aplicativo de exemplo seguinte remove a sampleSection seção. Após a remoção, o aplicativo não é possível recuperar as configurações que estão em sampleSection. 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."

<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

Remove(String)

Remove(String)

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)

Desmarque 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