Elemento clear per configSections (schema delle impostazioni generali)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Rimuove tutti i riferimenti alle sezioni e ai gruppi di sezioni ereditati consentendo solo quelli aggiunti dagli elementi section e sectionGroup correnti.

Elemento configuration (schema delle impostazioni generali)
  Elemento configSections (schema delle impostazioni generali)
    Elemento clear per configSections (schema delle impostazioni generali)
      Elemento configuration (schema delle impostazioni generali)
        Elemento configSections (schema delle impostazioni generali)
          Elemento sectionGroup per configSections (schema delle impostazioni generali)
            Elemento clear per configSections (schema delle impostazioni generali)

<clear />

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Nessuno.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
configSections	Specifica le dichiarazioni delle sezioni di configurazione e degli spazi dei nomi.
sectionGroup	Definisce un'associazione tra un gestore della sezione di configurazione e una sezione di configurazione.

Note

L'elemento clear rimuove tutti i riferimenti alle sezioni e ai gruppi di sezioni ereditati consentendo solo quelli aggiunti dagli elementi section e sectionGroup correnti.

Se un file di configurazione tenta di utilizzare una sezione di configurazione dopo che il riferimento al gestore è stato rimosso, in ASP.NET viene generato l'errore del server "Sezione di configurazione element_name non riconosciuta".

Esempio

Nell'esempio di codice 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 Machine.config del computer.

Nell'esempio di codice riportato di seguito estratto da un file Machine.config vengono dichiarate due sezioni, sampleSection e anotherSampleSection, che vengono lette prima del file di configurazione dell'applicazione.

<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 di un file di configurazione dell'applicazione vengono cancellate tutte le sezioni dichiarate in precedenza. Non è possibile utilizzare o recuperare le impostazioni in nessuna delle due sezioni dichiarate nel file Machine.config. È, tuttavia, possibile utilizzare le impostazioni contenute in anotherSection, in quanto tale sezione si trova dopo l'elemento clear.

<section name="anotherSection"

type="System.Configuration.NameValueSectionHandler" />

</configSections>

</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione	Non applicabile.
Membro di configurazione	Clear() Clear()
Percorsi configurabili	Machine.config Web.config a livello di radice Web.config a livello di applicazione Web.config a livello di directory fisica o virtuale
Requisiti	Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 .NET Framework versione 1.0, 1.1 o 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Condividi tramite

Elemento clear per configSections (schema delle impostazioni generali)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Esempio

Informazioni sull'elemento

Vedere anche

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive