Elemento clear 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 tutti i riferimenti alle sezioni e ai gruppi di sezioni ereditati consentendo solo quelli aggiunti dagli elementi section e sectionGroup correnti.
<clear />
Attributi ed elementi
Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli 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.
<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 remove 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