Elemento sectionGroup per configSections (schema delle impostazioni generali)

Articolo
08/11/2011

Definisce un'associazione tra un gestore della sezione di configurazione e una sezione di configurazione.

<sectionGroup 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token">
   <section />
/>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute	Oggetto di descrizione
name	Attributo String obbligatorio. Specifica il nome della sezione di configurazione o dell'elemento associato al gestore della sezione di configurazione specificato dall'attributo type. Si tratta del nome dell'elemento group come appare nell'area delle impostazioni della sezione del file di configurazione.
type	Attributo String obbligatorio. Specifica il nome della classe relativa al gestore della sezione di configurazione che gestisce l'elaborazione delle impostazioni di configurazione presenti nella sezione o nell'elemento specificato nell'attributo name. Utilizzare il seguente formato: type="nome completo classe, nome file assembly, versione, impostazioni cultura, token di chiave pubblica" È necessario che la definizione corrisponda al riferimento all'assembly. Se, ad esempio, il numero di versione dell'esempio di codice riportato di seguito non corrisponde all'assembly, si verifica un errore. `type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"` Il file assembly deve trovarsi nella stessa directory dell'applicazione del file Web.config che lo definisce. Nel caso del file radice Web.config o del file Machine.config, il file di assembly deve trovarsi nella directory %SystemRoot%\Microsoft.NET\Framework\versione.

Attribute

Oggetto di descrizione

name

Attributo String obbligatorio.

Specifica il nome della sezione di configurazione o dell'elemento associato al gestore della sezione di configurazione specificato dall'attributo type. Si tratta del nome dell'elemento group come appare nell'area delle impostazioni della sezione del file di configurazione.

type

Attributo String obbligatorio.

Specifica il nome della classe relativa al gestore della sezione di configurazione che gestisce l'elaborazione delle impostazioni di configurazione presenti nella sezione o nell'elemento specificato nell'attributo name. Utilizzare il seguente formato:

type="nome completo classe, nome file assembly, versione, impostazioni cultura, token di chiave pubblica"

È necessario che la definizione corrisponda al riferimento all'assembly. Se, ad esempio, il numero di versione dell'esempio di codice riportato di seguito non corrisponde all'assembly, si verifica un errore.

type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"

Il file assembly deve trovarsi nella stessa directory dell'applicazione del file Web.config che lo definisce. Nel caso del file radice Web.config o del file Machine.config, il file di assembly deve trovarsi nella directory %SystemRoot%\Microsoft.NET\Framework\versione.

Elementi figlio

Elemento	Oggetto di descrizione
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.
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 sectionGroup funge da contenitore per gli elementi section. Un elemento section associa un gestore della sezione di configurazione a una sezione o a un elemento di configurazione. È necessario 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.

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 di codice riportato di seguito viene illustrato come dichiarare le sezioni all'interno di un gruppo di sezioni.

<configuration>
   <configSections>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler" />
      </sectionGroup>
   </configSections>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione	Non applicabile.
Membro di configurazione	ConfigurationSectionGroup
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 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Condividi tramite