Elemento configSections (schema delle impostazioni generali)

Articolo
05/27/2012

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

Specifica le dichiarazioni delle sezioni di configurazione e degli spazi dei nomi.

   <configSections>
      <section />
      <sectionGroup />
      <remove />
      <clear/>
   </configSections>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
clear	Rimuove tutti i riferimenti alle sezioni e ai gruppi di sezioni ereditati consentendo solo quelli aggiunti dagli elementi section e sectionGroup correnti.
remove	Rimuove un riferimento a una sezione e a un gruppo di sezioni ereditati.
section	Definisce un'associazione tra un gestore della sezione di configurazione e un elemento di configurazione.
sectionGroup	Definisce un'associazione tra un gestore della sezione di configurazione e una sezione di configurazione.

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.

Note

L'elemento configSections specifica le dichiarazioni del gestore e della sezione di configurazione. Questa operazione è necessaria in quanto in ASP.NET la gestione delle impostazioni all'interno di un file di configurazione non viene data per scontata, bensì l'elaborazione dei dati di configurazione viene delegata ai gestori delle sezioni di configurazione.

Ciascun elemento section identifica un elemento o una sezione di configurazione e la classe derivata da ConfigurationSection associata che gestisce l'elemento o la sezione. È possibile raggruppare logicamente gli elementi section in elementi sectionGroup in modo da organizzarli ed evitare conflitti di denominazione. Gli elementi section e sectionGroup sono contenuti nell'elemento configSections.

Se l'elemento configSections si trova in un file di configurazione, configSections deve essere il primo elemento figlio dell'elemento configuration.

Configurazione predefinita

Le sezioni di configurazione per gli elementi di configurazione .NET sono definite nel file Machine.config e sono troppo numerose per essere elencate in questa sede. Nel frammento del file di configurazione Machine.config riportato di seguito viene definito il gestore della sezione di configurazione per l'elemento authentication della sezione system.web. Vengono quindi definite le impostazioni di configurazione per l'elemento authentication.

Se un gestore della sezione di configurazione non viene associato a un elemento di configurazione, in ASP.NET viene generato l'errore del server "Sezione di configurazione nome_elemento non riconosciuta".

<configuration>
    <configSections>
        <sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
            <section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
            <!-- Other system.web sections -->
        </sectionGroup>
        <!-- Other configuration sections -->
    </configSections>

    <system.web>
        <authentication mode="Windows">
            <forms name=".ASPXAUTH" 
                   loginUrl="login.aspx" defaultUrl="default.aspx" 
                   protection="All" 
                   timeout="30" 
                   path="/" 
                   requireSSL="False" 
                   slidingExpiration="True" 
                   cookieless="UseCookies" 
                   domain="" 
                   enableCrossAppRedirects="False">
                <credentials passwordFormat="SHA1" />
            </forms>
            <passport redirectUrl="internal" />
        </authentication>
        <!-- Other system.web elements -->
    </system.web>
    <!-- Other configuration settings -->
</configuration>

Esempio

Nell'esempio riportato di seguito viene illustrato come definire una sezione di configurazione personalizzata e specificare le relative impostazioni.

<configuration>

   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1="Value1" 
                  setting2="value two" 
                  setting3="third value" />

</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione	Non applicabile.
Membro di configurazione	ConfigurationSectionCollection ConfigurationSectionGroupCollection
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