Elemento section per 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.]

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

<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

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi 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. ValoreDescrizione Everywhere Consente la configurazione della sezione in qualsiasi directory o file di configurazione, come descritto di seguito: Machine.config Web.config radice. 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 radice. 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 radice. 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. ValoreDescrizione 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. Il valore predefinito è 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	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

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

Share via