Sdílet prostřednictvím


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

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.

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é

Odkaz

Element configSections (Obecné schéma nastavení)

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

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

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

Element configuration (schéma obecného nastavení)

Koncepty

Hierarchie a dědičnost konfiguračních souborů technologie ASP.NET

Úpravy souborů konfigurace technologie ASP.NET

Scénáře konfigurace technologie ASP.NET

Další zdroje

Obecné nastavení konfigurace (technologie ASP.NET)

Nastavení konfigurace ASP.NET

Konfigurační soubory technologie ASP.NET

Správa webu ASP.NET

Rozhraní API konfigurace technologie ASP.NET