Element configSections (Obecné schéma nastavení)

Článek
08/11/2011

Určuje oddíl konfigurace a deklarace oboru názvů.

   <configSections>
      <section />
      <sectionGroup />
      <remove />
      <clear/>
   </configSections>

Atributy a prvky

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

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

Žádný

Podřízené prvky

Prvek	Popis
clear	Odebere všechny odkazy na zděděné oddíly a skupiny oddílů s tím, že povolí pouze ty oddíly a skupiny oddílů, které jsou přidány pomocí aktuálních elementů section a sectionGroup.
remove	Odebere odkaz na zděděný oddíl a skupinu oddílů.
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.

Poznámky

Element configSections určuje deklaraci oddílu konfigurace a obslužné rutiny. To je požadováno, 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 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.

Pokud je element configSections v konfiguračním souboru, musí být element configSections první podřízený element elementu configuration.

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 definovat vlastní oddíl konfigurace a nastavení pro daný oddíl.

<configuration>

   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1="Value1" 
                  setting2="value two" 
                  setting3="third value" />

</configuration>

Informace prvku

Obslužná rutina konfiguračního oddílu	Nelze aplikovat.
Konfigurační člen	ConfigurationSectionCollection ConfigurationSectionGroupCollection
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 1.0, 1.1 nebo 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím