Elemento section per configSections (schema delle impostazioni generali)

Articolo
09/12/2008

Aggiornamento: novembre 2007

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

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

<section 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token"
   allowDefinition= "Everywhere|MachineOnly|MachineToApplication|MachineToWebRoot" 
   allowLocation="True|False" 
   restartOnExternalChanges="True|False" 
/>

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Attributo

Descrizione

allowDefinition

Attributo Enum facoltativo.

Valido esclusivamente per le applicazioni ASP.NET.

Specifica il file di configurazione in cui è possibile utilizzare la sezione.

Questo attributo può essere uno dei valori riportati di seguito, definiti nell'enumerazione ConfigurationAllowDefinition, in ordine di ambito decrescente.

Valore	Descrizione
Everywhere	Consente la configurazione della sezione in qualsiasi directory o file di configurazione, come descritto di seguito: Machine.config Web.config principale. Web.config per un'applicazione. Directory virtuale. Sottodirectory fisica dell'applicazione. Se non viene utilizzato alcun attributo allowDefinition, si presuppone l'utilizzo di Everywhere. Questa è l'impostazione predefinita.
MachineToApplication	Consente la configurazione della sezione in uno dei file seguenti: Machine.config Web.config principale. Web.config per un'applicazione. Sono esclusi i file Web.config nelle directory virtuali o in una sottodirectory fisica dell'applicazione.
MachineToWebRoot	Consente la configurazione della sezione in uno dei file seguenti: Machine.config Web.config principale. Il file Machine.config e il file radice Web.config si trovano entrambi in %SystemRoot%\Microsoft.NET\Framework\Numeroversione\CONFIG.
MachineOnly	Consente di configurare la sezione solo nel file Machine.config che si trova in %SystemRoot%\Microsoft.NET\Framework\Numeroversione\CONFIG.

allowExeDefinition

Attributo Enum facoltativo.

Valido esclusivamente per le applicazioni client .NET Framework.

Specifica il file di configurazione in cui è possibile utilizzare la sezione.

Questo attributo può essere uno dei valori riportati di seguito, definiti nell'enumerazione ConfigurationAllowExeDefinition, in ordine di ambito decrescente.

Valore	Descrizione
MachineToApplication	Consente la configurazione della sezione in uno dei file seguenti: Machine.config Configurazione dell'applicazione.
MachineToRoamingUser
MachineToLocalUser
MachineOnly	Consente di configurare la sezione solo nel file Machine.config che si trova in %SystemRoot%\Microsoft.NET\Framework\Numeroversione\CONFIG.

allowLocation

Attributo Boolean facoltativo.

Valido esclusivamente per le applicazioni ASP.NET.

Specifica se la sezione può essere utilizzata all'interno dell'elemento location.

L'impostazione predefinita è True.

name

Attributo String obbligatorio.

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

restartOnExternalChanges

Attributo Boolean facoltativo.

Non è valido per le applicazioni ASP.NET.

Specifica se riavviare l'applicazione, qualora i dati di configurazione della sezione vengano modificati.

type

Attributo String obbligatorio.

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

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

È necessario che la definizione corrisponda al riferimento all'assembly. Se, ad esempio, il numero di versione della sintassi di esempio riportata 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 in %SystemRoot%\Microsoft.NET\Framework\versione.

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	Consente di specificare le dichiarazioni delle sezioni di configurazione e degli spazi dei nomi.
sectionGroup	Consente di definire un'associazione tra un gestore della sezione di configurazione e una sezione di configurazione.

Note

Un elemento section associa un gestore della sezione di configurazione a una sezione o a un elemento 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 per consentirne l'organizzazione e per 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 Framework 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 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	ConfigurationSection
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