Dela via

<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å.

Se även