<elemento sezione>
Contiene una dichiarazione di sezione di configurazione.
<Configurazione>
<configSections>
<Sezione>
<Configurazione>
<configSections>
<Sectiongroup>
<Sezione>
Sintassi
<section name="section name"
type="configuration section handler class, assembly"
allowDefinition="Everywhere|MachineOnly|MachineToApplication"
allowLocation="true|false" />
Attributi richiesti
| Descrizione | |
|---|---|
| nome | Specifica il nome della sezione di configurazione. |
| type | Specifica il nome della classe del gestore della sezione di configurazione che legge la sezione dal file di configurazione. Il valore del tipo ha la sintassi "fully-qualified-section-handler-class-name, simple-assembly-name". Il nome dell'assembly semplice è il nome del file radice senza l'estensione del file.dll . |
Attributi facoltativi
Gli attributi seguenti sono applicabili solo per le applicazioni ASP.NET. Il sistema di configurazione ignora questi attributi per altri tipi di applicazione.
| Descrizione | |
|---|---|
| Allowdefinition | Specifica il file di configurazione in cui è possibile usare la sezione. Usare uno dei valori seguenti: Ovunque Consente di usare la sezione in qualsiasi file di configurazione. Questo è il valore predefinito. MachineOnly Consente di usare la sezione solo nel file di configurazione del computer (Machine.config). MachineToApplication Consente di usare la sezione nel file di configurazione del computer o nel file di configurazione dell'applicazione. |
| allowLocation | Determina se la sezione può essere usata all'interno dell'elemento <location> . Usare uno dei valori seguenti: true Consente di utilizzare la sezione all'interno dell'elemento <location> . Questo è il valore predefinito. false Non consente l'uso della sezione all'interno dell'elemento <location> . |
Elementi padre
| Descrizione | |
|---|---|
| <Elemento configSections> | Contiene dichiarazioni di configurazione e spazio dei nomi. |
| <elemento sectionGroup> | Definisce uno spazio dei nomi per le sezioni di configurazione. |
Nota
Un <elemento di sezione> è un elemento figlio di <configSections> o <sectionGroup> , ma non entrambi.
Elementi figlio
nessuno
Osservazioni
La dichiarazione di una sezione di configurazione definisce essenzialmente un nuovo elemento per il file di configurazione. Il nuovo elemento contiene le impostazioni che un gestore della sezione di configurazione , ovvero una classe che implementa l'interfaccia IConfigurationSectionHandler , legge. Gli attributi e gli elementi figlio di una sezione definiti dipendono dal gestore della sezione usato per leggere le impostazioni.
La dichiarazione di un gestore della sezione di configurazione nel file Machine.config consente di usare la sezione di configurazione in qualsiasi file di configurazione dell'applicazione nel computer, a meno che l'attributo allowDefinition non specifichi altrimenti.
Esempio
Nell'esempio seguente viene illustrato come definire una sezione di configurazione e definire le impostazioni per tale sezione:
<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
Questo elemento può essere usato nel file di configurazione dell'applicazione, nel file di configurazione del computer (Machine.config ) e nei fileWeb.confignon a livello di directory dell'applicazione.
