<section> komponent

Innehåller en konfigurationsavsnittsdeklaration.

<konfiguration>
   <konfigurationSections>
     <sektion>

<konfiguration>
   <konfigurationSections>
     <sectionGroup>
       <sektion>

Syntax

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

Obligatoriska attribut

	Description
name	Anger namnet på konfigurationsavsnittet.
type	Anger namnet på konfigurationsavsnittshanterarklassen 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 valfri konfigurationsfil. 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 elementet <location> . Använd något av följande värden: sann Tillåter att avsnittet används i elementet <location> . Det här är standardinställningen. falsk Tillåter inte att avsnittet används i elementet <location> .

Överordnade element

	Description
<configSections> Element	Innehåller konfigurationsavsnitt och namnområdesdeklarationer.
<sectionGroup> Element	Definierar ett namnområde för konfigurationsavsnitt.

Anmärkning

Ett <section> element är ett underordnat element i antingen <configSections> eller <sectionGroup> men inte båda.

Underordnade element

None

Anmärkningar

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 allowDefinition attributet anger något annat.

Example

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

• Konfigurationsfilschema för .NET Framework