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

Článek
08/11/2011

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é

Sdílet prostřednictvím