Elemento remove per configSections (schema delle impostazioni generali)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Rimuove un riferimento a una sezione e a un gruppo di sezioni ereditati.

Elemento configuration (schema delle impostazioni generali)
  Elemento configSections (schema delle impostazioni generali)
    Elemento remove 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 remove per configSections (schema delle impostazioni generali)

<remove 
   name="section name" 
/>

Attributi ed elementi

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

Attributi

Attributo	Descrizione
name	Attributo String obbligatorio. Specifica il nome della sezione o del gruppo di sezioni da rimuovere. Corrisponde all'attributo name nell'elemento section o sectionGroup da cui è stato aggiunto il riferimento.

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 remove rimuove un riferimento alle sezioni o ai gruppi di sezioni ereditati. È possibile aggiungere le nuove sezioni e gruppi di sezioni all'insieme nel file di configurazione corrente utilizzando gli elementi section e sectionGroup.

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 nome_elemento non riconosciuta".

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare l'elemento remove nel file di configurazione di un'applicazione per rimuovere una sezione definita in precedenza nel file Machine.config.

Il codice del file Machine.config riportato di seguito dichiara una sezione denominata sampleSection.

<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

Nel file di configurazione dell'applicazione di esempio riportato di seguito viene rimossa la sezione sampleSection. Dopo la rimozione, non è più possibile recuperare le impostazioni contenute in sampleSection. 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 nome_elemento non riconosciuta".

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

Informazioni sull'elemento

Gestore della sezione di configurazione	Non applicabile.
Membro di configurazione	Remove(String) Remove(String)
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 remove 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