Podelement sectionGroup elementu configSections (obecné schéma nastavení)

Článek
08/11/2011

Definuje vztah mezi obslužnou rutinou oddílu konfigurace a konfiguračním oddílem.

<sectionGroup 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token">
   <section />
/>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
name	Požadované String atributu. Určuje název oddílu konfigurace nebo element, který je spojen s oddílem konfigurace obslužné rutiny, který je určen atributem type. Toto je název elementu group, pod jakým se objevuje v oblasti nastavení oddílu konfiguračního souboru.
type	Požadovaný atribut typu String. Určuje název třídy obslužné rutiny oddílu konfigurace, která obsluhuje zpracování nastavení konfigurace, která jsou v oddíle nebo elementu, který je určen v atributu name. Použijte následující formát: type="Plně kvalifikovaný název třídy,název souboru sestavení,verze,kultura,token veřejného klíče" Definice musí odpovídat odkazu na sestavení. Například pokud číslo verze v následujícím příkladu kódu neodpovídá sestavení, dojde k chybě. `type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"` Soubor sestavení musí být umístěn ve stejném adresáři aplikace jako soubor web.config, který jej definuje. V případě kořenového souboru web.config nebo machine.config, musí být soubor sestavení v adresáři %SystemRoot%\Microsoft.NET\Framework\verze.

Atribut

Popis

name

Požadované String atributu.

Určuje název oddílu konfigurace nebo element, který je spojen s oddílem konfigurace obslužné rutiny, který je určen atributem type. Toto je název elementu group, pod jakým se objevuje v oblasti nastavení oddílu konfiguračního souboru.

type

Požadovaný atribut typu String.

Určuje název třídy obslužné rutiny oddílu konfigurace, která obsluhuje zpracování nastavení konfigurace, která jsou v oddíle nebo elementu, který je určen v atributu name. Použijte následující formát:

type="Plně kvalifikovaný název třídy,název souboru sestavení,verze,kultura,token veřejného klíče"

Definice musí odpovídat odkazu na sestavení. Například pokud číslo verze v následujícím příkladu kódu neodpovídá sestavení, dojde k chybě.

type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"

Soubor sestavení musí být umístěn ve stejném adresáři aplikace jako soubor web.config, který jej definuje. V případě kořenového souboru web.config nebo machine.config, musí být soubor sestavení v adresáři %SystemRoot%\Microsoft.NET\Framework\verze.

Podřízené prvky

Prvek	Popis
section	Definuje vztah mezi obslužnou rutinou oddílu konfigurace a konfiguračním elementem.
sectionGroup	Definuje vztah mezi obslužnou rutinou oddílu konfigurace a konfiguračním oddílem.

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
configSections	Určuje oddíl konfigurace a deklarace oboru názvů.
sectionGroup	Definuje vztah mezi obslužnou rutinou oddílu konfigurace a konfiguračním oddílem.

Poznámky

Element sectionGroup se chová jako kontejner pro prvky section. Element section přidruží obslužnou rutinu konfiguračního oddílu ke konfiguračnímu prvku nebo oddílu. To je nezbytné, protože technologie ASP.NET nečiní žádné předpoklady o tom, jak zpracovat nastavení v rámci konfiguračního souboru. Místo toho technologie ASP.NET přenese zpracování údajů o konfiguraci na obslužné rutiny oddílu konfigurace. Každý element section identifikuje oddíl konfigurace nebo element a přidruženou třídou, která je odvozená od třídy ConfigurationSection, která zpracovává konfigurační oddíl nebo prvek. Elementy section mohou být logicky seskupeny do elementů sectionGroup za účelem organizace prvků section a vyhnutí se konfliktům pojmenování. Elementy section a sectionGroup jsou obsaženy v elementu configSections.

Výchozí konfigurace

Oddíly konfigurace pro konfigurační prvky .NET jsou definovány v souboru Machine.config a je jich příliš mnoho pro jejich výpis zde. Následující úryvek ze souboru Machine.config definuje obslužnou rutinu konfiguračního oddílu elementu authentication oddílu system.web. Potom je pro element authentication definováno nastavení konfigurace.

Pokud obslužná rutina konfiguračního oddílu není přidružena konfiguračnímu elementu, vyvolá technologie ASP.NET chybu serveru "Nerozpoznaný oddíl konfigurace název_elementu."

<configuration>
    <configSections>
        <sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
            <section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
            <!-- Other system.web sections -->
        </sectionGroup>
        <!-- Other configuration sections -->
    </configSections>

    <system.web>
        <authentication mode="Windows">
            <forms name=".ASPXAUTH" 
                   loginUrl="login.aspx" defaultUrl="default.aspx" 
                   protection="All" 
                   timeout="30" 
                   path="/" 
                   requireSSL="False" 
                   slidingExpiration="True" 
                   cookieless="UseCookies" 
                   domain="" 
                   enableCrossAppRedirects="False">
                <credentials passwordFormat="SHA1" />
            </forms>
            <passport redirectUrl="internal" />
        </authentication>
        <!-- Other system.web elements -->
    </system.web>
    <!-- Other configuration settings -->
</configuration>

Příklad

Následující příklad kódu ukazuje, jak deklarovat skupinu oddílu a deklarovat oddíly v rámci skupiny oddílu.

<configuration>
   <configSections>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler" />
      </sectionGroup>
   </configSections>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

Informace prvku

Obslužná rutina konfiguračního oddílu	Nelze aplikovat.
Konfigurační člen	ConfigurationSectionGroup
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework verze 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím