Sdílet prostřednictvím


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

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

<section 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token"
   allowDefinition= "Everywhere|MachineOnly|MachineToApplication|MachineToWebRoot" 
   allowLocation="True|False" 
   restartOnExternalChanges="True|False" 
/>

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

allowDefinition

Volitelný Enum atributu.

Týká se pouze aplikací technologie ASP.NET.

Určuje, ve kterém konfiguračním souboru může být oddíl použit.

Tento atribut může nabývat následujících hodnot (definované v ConfigurationAllowDefinition výčtu) v pořadí snižující oboru.

HodnotaPopis
Everywhere Umožňuje nakonfigurovat oddíl v libovolném konfiguračním souboru nebo adresáři, a to takto:
  • Machine.config.

  • Kořenový Web.config.

  • Web.config dané aplikace.

  • Virtuální adresář.

  • Fyzický podadresář v aplikaci.

Pokud není použit atribut allowDefinition, předpokládá se Everywhere.Tato možnost je výchozí.
MachineToApplication Umožňuje nakonfigurovat sekci v jednom z následujících souborů:
  • Machine.config.

  • Kořenový Web.config.

  • Web.config dané aplikace.

Nezahrnuje soubory Web.config ve virtuálních adresářích nebo fyzickém podadresáři aplikace.
MachineToWebRoot Umožňuje nakonfigurovat sekci v jednom z následujících souborů:
  • Machine.config.

  • Kořenový Web.config.

Soubory Machine.config a kořenový Web.config jsou umístěny v %SystemRoot%\Microsoft.NET\Framework\číslo_verze \Config.
MachineOnly Umožňuje konfiguraci sekce pouze v souboru Machine.config, který se nachází v %SystemRoot%\Microsoft.NET\Framework\číslo_verze \Config.

allowExeDefinition

Nepovinný atribut Enum.

Týká se pouze klientských aplikací platformy .NET Framework.

Určuje, ve kterém konfiguračním souboru může být oddíl použit.

Tento atribut může nabývat následujících hodnot (definované v ConfigurationAllowExeDefinition výčtu) v pořadí snižující oboru.

HodnotaPopis
MachineToApplication Umožňuje nakonfigurovat sekci v jednom z následujících souborů:
  • Machine.config.

  • Konfigurace aplikace.

MachineToRoamingUser
MachineToLocalUser
MachineOnly Umožňuje konfiguraci sekce pouze v souboru Machine.config, který se nachází v %SystemRoot%\Microsoft.NET\Framework\číslo_verze \Config.

allowLocation

Nepovinný atribut Boolean.

Týká se pouze aplikací technologie ASP.NET.

Určuje, zda lze oddíl použít v rámci elementu location.

Výchozí hodnota je True.

name

Požadovaný atribut typu String.

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, pod jakým se objevuje v oblasti nastavení oddílu konfiguračního souboru.

restartOnExternalChanges

Nepovinný atribut Boolean.

Nevztahuje se na aplikace technologie ASP.NET.

Určuje, zda se má aplikace restartovat, pokud se změní konfigurační data oddílu.

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 syntaxe 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ý definuje soubor sestavení. 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

Žádný

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 section přidruží obslužnou rutinu konfiguračního oddílu ke konfiguračnímu prvku nebo oddílu. 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ů a pro pomoc s vyhnutím 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 Framework 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 určit 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

ConfigurationSection

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é

Odkaz

Element configSections (Obecné schéma nastavení)

Podelement sectionGroup 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