Compartir a través de

Elemento <clear> para <configSections>

  • Artículo

Borra todas las secciones y grupos de secciones definidas anteriormente.

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

<clear/>

Comentarios

El elemento <clear> quita todas las secciones y grupos de secciones de la aplicación definidas anteriormente en el archivo de configuración actual o en un nivel superior de la jerarquía de archivos de configuración.

Ejemplo

En el ejemplo siguiente se muestra cómo utilizar el elemento <clear> en un archivo de configuración de la aplicación para borrar las secciones definidas anteriormente en el archivo de configuración del equipo.

En el siguiente ejemplo, se declaran dos secciones en el código de archivo de configuración del equipo, <sampleSection> y <anotherSampleSection>, que se leen antes de leer el archivo de configuración de la aplicación.

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

El siguiente código de archivo de configuración de la aplicación borra todas las secciones declaradas anteriormente. En esta aplicación no se pueden utilizar ni recuperar los valores de ninguna de las secciones declaradas en el archivo de configuración del equipo. Sin embargo, se pueden utilizar los valores de <anotherSection> ya que está después del elemento <clear>.

<!-- Application configuration file. -->
<configuration>
   <configSections>
      <clear/>
      <section name="anotherSection"
               type="System.Configuration.NameValueSectionHandler" />
    </configSections>
</configuration>

Archivo de configuración

Este elemento se puede utilizar en el archivo de configuración de la aplicación, en el archivo de configuración del equipo (Machine.config) y en los archivos Web.config que no se encuentran en el directorio de la aplicación.

Vea también

Esquema de secciones de configuración | Valores de la sección de configuración