Remover elemento configSections (Geral Settings esquema)

Artigo
08/25/2010

Remove uma referência a uma seção herdada e agrupar de seção.

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

<remove 
   name="section name" 
/>

Atributos e elementos

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

Atributos

Atributo	Descrição
name	Necessário String atributo. Especifica o nome da seção ou agrupar da seção para remover. Isso é igual a name o atributo na seção or sectionGroupelemento de adicionada a referência.

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

O seguinte código do arquivo computador.config 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 do exemplo a seguir remove o 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 o manipulador de referência é removida, ASP.NET emitirá o erro de servidor, seção de configuração desconhecido"element_name."

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

Partilhar via

Remover elemento configSections (Geral Settings esquema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Exemplo

Informações do elemento

Consulte também

Conceitos

Referência

Outros recursos

Recursos adicionais