Elemento <section>

  • Articolo

Contiene una dichiarazione della sezione di configurazione.

<configuration>
   <configSections>
      <section>

<configuration>
   <configSections>
      <sectionGroup>
         <section>

<section
   name="section name"type="configuration section handler class, assembly"   allowDefinition="Everywhere|MachineOnly|MachineToApplication"    allowLocation="true|false" />

Attributi obbligatori

Attributo Descrizione
name Specifica il nome della sezione di configurazione.
type Specifica il nome della classe relativa al gestore della sezione di configurazione che legge la sezione dal file di configurazione.

Attributi facoltativi

Di seguito vengono indicati gli attributi supportati solo nelle applicazioni ASP.NET. Tali attributi vengono ignorati dal sistema di configurazione durante l'esecuzione di altre applicazioni.

Attributo Descrizione
allowDefinition Specifica il file di configurazione in cui è possibile utilizzare la sezione. Utilizzare uno dei valori indicati di seguito.
Everywhere
Consente di utilizzare la sezione in qualsiasi file di configurazione. Rappresenta l'impostazione predefinita.
MachineOnly
Consente di utilizzare la sezione solo nel file di configurazione del computer (Machine.config).
MachineToApplication
Consente di utilizzare la sezione nel file di configurazione del computer o dell'applicazione.
allowLocation Determina se la sezione può essere utilizzata all'interno dell'elemento <location>. Utilizzare uno dei valori indicati di seguito.
true
Consente l'uso della sezione all'interno dell'elemento <location>. Rappresenta l'impostazione predefinita.
false
Non consente l'uso della sezione all'interno dell'elemento <location>.

Osservazioni

La dichiarazione di una sezione di configurazione definisce in sostanza un nuovo elemento per il file di configurazione. Tale elemento contiene le impostazioni lette dal gestore della sezione di configurazione, ossia una classe per l'implementazione dell'interfaccia IConfigurationSectionHandler. Gli attributi e gli elementi figlio di una sezione definiti dipendono dal gestore della sezione utilizzato per la lettura delle impostazioni.

La dichiarazione di un gestore della sezione di configurazione nel file Machine.config consente di utilizzare la sezione di configurazione in qualsiasi file di configurazione dell'applicazione su tale computer, a meno che l'attributo allowDefinition non definisca un'impostazione diversa.

Esempio

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

<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" 
               allowLocation="false"/>
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

File di configurazione

L'elemento può essere utilizzato nei file di configurazione dell'applicazione e del computer (Machine.config), nonché nei file Web.config che non si trovano al livello di directory dell'applicazione.

Vedere anche

Elemento personalizzato per NameValueSectionHandler e DictionarySectionHandler | Elemento personalizzato per SingleTagSectionHandler | Impostazioni delle sezioni di configurazione | Elemento <sectionGroup> | Schema delle sezioni di configurazione