Elemento <clear> per <configSections>

  • Articolo

Cancella tutte le sezioni e i gruppi di sezioni definiti in precedenza.

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

<clear/>

Osservazioni

L'elemento <clear> rimuove dall'applicazione in uso tutte le sezioni e i gruppi di sezioni che erano stati definiti in precedenza nel file di configurazione corrente o a un livello superiore nella gerarchia dei file di configurazione.

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare l'elemento <clear> nel file di configurazione di un'applicazione per cancellare le sezioni definite in precedenza nel file di configurazione del computer.

Nel seguente codice del file di configurazione del computer vengono dichiarate due sezioni, <sampleSection> e <anotherSampleSection>, che vengono lette prima del file di configurazione dell'applicazione.

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

Nel seguente codice del file di configurazione dell'applicazione vengono cancellate tutte le sezioni dichiarate in precedenza. Non è possibile utilizzare o recuperare mediante l'applicazione le impostazioni contenute nelle sezioni che erano state dichiarate nel file di configurazione del computer. Per contro, è possibile utilizzare le impostazioni contenute in <anotherSection>, in quanto tale sezione si trova dopo l'elemento <clear>.

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

File di configurazione

L'elemento può essere utilizzato nei file di configurazione dell'applicazione e del computer (Machine.config), nonché nei file Web.config che non si trovano al livello di directory dell'applicazione.

Vedere anche

Schema delle sezioni di configurazione | Impostazioni delle sezioni di configurazione