<section-element>
Innehåller en konfigurationsavsnittsdeklaration.
<Konfiguration>
<configSections>
<Avsnitt>
<Konfiguration>
<configSections>
<sectionGroup>
<Avsnitt>
Syntax
<section name="section name"
type="configuration section handler class, assembly"
allowDefinition="Everywhere|MachineOnly|MachineToApplication"
allowLocation="true|false" />
Obligatoriska attribut
| Description | |
|---|---|
| Namn | Anger namnet på konfigurationsavsnittet. |
| Typ | Anger namnet på den konfigurationsavsnittshanterarklass som läser avsnittet från konfigurationsfilen. Typvärdet har syntaxen "fully-qualified-section-handler-class-name, simple-assembly-name". Det enkla sammansättningsnamnet är rotfilnamnet utan filnamnstillägget.dll . |
Valfria attribut
Följande attribut gäller endast för ASP.NET program. Konfigurationssystemet ignorerar dessa attribut för andra programtyper.
| Description | |
|---|---|
| allowDefinition | Anger vilken konfigurationsfil som avsnittet kan användas i. Använd något av följande värden: Överallt Tillåter att avsnittet används i alla konfigurationsfiler. Det här är standardinställningen. MachineOnly Tillåter att avsnittet endast används i datorkonfigurationsfilen (Machine.config). MachineToApplication Tillåter att avsnittet används i datorkonfigurationsfilen eller programkonfigurationsfilen. |
| allowLocation | Avgör om avsnittet kan användas i <platselementet> . Använd något av följande värden: Sant Tillåter att avsnittet används i <platselementet> . Det här är standardinställningen. Falska Tillåter inte att avsnittet används i <platselementet> . |
Överordnade element
| Description | |
|---|---|
| <configSections-element> | Innehåller konfigurationsavsnitt och namnområdesdeklarationer. |
| <sectionGroup-element> | Definierar ett namnområde för konfigurationsavsnitt. |
Anteckning
Ett <avsnittselement> är ett underordnat element i antingen< configSections> eller <sectionGroup>, men inte båda.
Underordnade element
Ingen
Kommentarer
När du deklarerar ett konfigurationsavsnitt definieras i princip ett nytt element för konfigurationsfilen. Det nya elementet innehåller inställningar som en konfigurationsavsnittshanterare (dvs. en klass som implementerar IConfigurationSectionHandler gränssnittet) läser. Attributen och underordnade element i ett avsnitt som du definierar beror på vilken avsnittshanterare du använder för att läsa inställningarna.
Om du deklarerar en konfigurationsavsnittshanterare i filenMachine.config kan du använda konfigurationsavsnittet i alla programkonfigurationsfiler på datorn, såvida inte attributet allowDefinition anger något annat.
Exempel
I följande exempel visas hur du definierar ett konfigurationsavsnitt och definierar inställningar för det avsnittet:
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler"
allowLocation="false" />
</configSections>
<sampleSection setting1="Value1"
setting2="value two"
setting3="third value" />
</configuration>
Konfigurationsfil
Det här elementet kan användas i programkonfigurationsfilen, datorkonfigurationsfilen (Machine.config) och Web.config filer som inte finns på programkatalognivå.
