Elemento remove per configSections (schema delle impostazioni generali)
[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]
Rimuove un riferimento a una sezione e a un gruppo di sezioni ereditati.
<remove
name="section name"
/>
Attributi ed elementi
Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli 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 alla raccolta 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 |
|
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
Riferimenti
Elemento configSections (schema delle impostazioni generali)
Elemento sectionGroup per configSections (schema delle impostazioni generali)
Elemento section per configSections (schema delle impostazioni generali)
Elemento clear per configSections (schema delle impostazioni generali)
Elemento configuration (schema delle impostazioni generali)
Concetti
ASP.NET Configuration File Hierarchy
Format of ASP.NET Configuration Files
Altre risorse
Impostazioni di configurazione generali (ASP.NET)
Impostazioni di configurazione di ASP.NET