<limpar > elemento para <configSections ><clear> element for <configSections>

Limpa todas as seções e grupos de seções definidos anteriormente.Clears all previously defined sections and section groups.

<configuration> <configuration>
   <configSections>   <configSections>
     <clear>    <clear>

SintaxeSyntax

<clear/>

AtributoAttribute

DescriçãoDescription
namename Atributo obrigatório.Required attribute.

Especifica o nome da seção ou do grupo de seções a ser removido.Specifies the name of the section or section group to remove.

Elemento paiParent element

DescriçãoDescription
<configsections > Elementos<configSections> Element Contém as declarações de namespace e seção de configuração.Contains configuration section and namespace declarations.

Child elementsChild elements

NenhumNone

ComentáriosRemarks

O <limpar > elemento remove todas as seções e os grupos de seções do aplicativo que foram definidos anteriormente no arquivo de configuração atual ou em um nível superior na hierarquia do arquivo de configuração.The <clear> element removes all sections and section groups from your application that were defined earlier in the current configuration file or at a higher level in the configuration file hierarchy.

{1>Exemplo<1}Example

Este exemplo define um arquivo de configuração de computador e um arquivo de configuração de aplicativo e mostra como usar o <apagar > elemento em um arquivo de configuração de aplicativo para limpar as seções definidas anteriormente no arquivo de configuração de computador.This example defines a machine configuration file and an application configuration file and shows how to use the <clear> element in an application configuration file to clear sections previously defined in the machine configuration file.

O código do arquivo de configuração de computador a seguir declara duas seções, <sampleSection > e <anotherSampleSection > , que são lidos antes do arquivo de configuração do aplicativo:The following machine configuration file code declares two sections, <sampleSection> and <anotherSampleSection>, which are read before the application configuration file:

<!-- Machine.config file -->
<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 do arquivo de configuração de aplicativo a seguir limpa todas as seções declaradas anteriormente.The following application configuration file code clears all previously declared sections. O aplicativo não pode usar ou recuperar as configurações em nenhuma das seções que foram declaradas no arquivo de configuração da máquina.The application cannot use or retrieve settings in either of the sections that were declared in the machine configuration file. No entanto, ele pode usar as configurações de <anotherSection > porque ele vem depois do elemento <Clear > .However, it can use settings from <anotherSection> because it comes after the <clear> element.

<!-- Application configuration file -->
<configuration>
  <configSections>
    <clear/>
    <section name="anotherSection"
             type="System.Configuration.NameValueSectionHandler" />
  </configSections>
  <anotherSection setting1="Value1" 
                 setting2="value two" 
                 setting3="third value" />
</configuration>

arquivo de configuraçãoConfiguration file

Esse elemento pode ser usado no arquivo de configuração do aplicativo, no arquivo de configuração do computador (Machine. config) e nos arquivos Web. config que não estão no nível do diretório do aplicativo.This element can be used in the application configuration file, machine configuration file (Machine.config), and Web.config files that are not at the application directory level.

Consulte tambémSee also