<section> – element
Obsahuje deklaraci oddílu konfigurace.
<Konfigurace>
<Configsections>
<Oddíl>
<Konfigurace>
<Configsections>
<Sectiongroup>
<Oddíl>
Syntax
<section name="section name"
type="configuration section handler class, assembly"
allowDefinition="Everywhere|MachineOnly|MachineToApplication"
allowLocation="true|false" />
Požadované atributy
Description | |
---|---|
Jméno | Určuje název oddílu konfigurace. |
typ | Určuje název třídy obslužné rutiny oddílu konfigurace, která čte oddíl z konfiguračního souboru. Hodnota typu má syntaxi "fully-qualified-section-handler-class-name, simple-assembly-name". Jednoduchý název sestavení je kořenový název souboru bez přípony souboru.dll . |
Volitelné atributy
Následující atributy platí pouze pro ASP.NET aplikace. Konfigurační systém tyto atributy pro jiné typy aplikací ignoruje.
Description | |
---|---|
Allowdefinition | Určuje, ve kterém konfiguračním souboru lze oddíl použít. Použijte jednu z následujících hodnot: Všude Umožňuje použití oddílu v libovolném konfiguračním souboru. Tato možnost je výchozí. MachineOnly Umožňuje použití oddílu pouze v konfiguračním souboru počítače (Machine.config). Machinetoapplication Umožňuje použití oddílu v konfiguračním souboru počítače nebo v konfiguračním souboru aplikace. |
allowLocation | Určuje, zda lze oddíl použít v rámci elementu <location> . Použijte jednu z následujících hodnot: Pravda Umožňuje použití oddílu v elementu <location> . Tato možnost je výchozí. False Nepovoluje použití oddílu v elementu <location> . |
Nadřazené prvky
Description | |
---|---|
<configSections> – element | Obsahuje oddíl konfigurace a deklarace oboru názvů. |
<sectionGroup> – element | Definuje obor názvů pro oddíly konfigurace. |
Poznámka
Element <section> je podřízený prvek buď< configSections>, nebo <sectionGroup>, ale ne oba.
Podřízené prvky
Žádné
Poznámky
Deklarování konfiguračního oddílu v podstatě definuje nový prvek pro konfigurační soubor. Nový element obsahuje nastavení, která načte obslužná rutina konfiguračního oddílu IConfigurationSectionHandler (tj. třída, která implementuje rozhraní). Atributy a podřízené prvky oddílu, který definujete, závisí na obslužné rutině oddílu, kterou použijete ke čtení nastavení.
Deklarování obslužné rutiny oddílu konfigurace v souboruMachine.config umožňuje použít konfigurační oddíl v libovolném konfiguračním souboru aplikace na tomto počítači, pokud atribut allowDefinition neurčuje jinak.
Příklad
Následující příklad ukazuje, jak definovat konfigurační oddíl a nastavení pro tento oddíl:
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler"
allowLocation="false" />
</configSections>
<sampleSection setting1="Value1"
setting2="value two"
setting3="third value" />
</configuration>
Konfigurační soubor
Tento prvek lze použít v konfiguračním souboru aplikace, konfiguračním souboru počítače (Machine.config) a Web.config souborech, které nejsou na úrovni adresáře aplikace.