Sdílet prostřednictvím

<section> prvek

Obsahuje deklaraci oddílu konfigurace.

<konfigurace>
   <configSections>
     <oddíl>

<konfigurace>
   <configSections>
     <sectionGroup>
       <oddíl>

Syntaxe

<section name="section name"
         type="configuration section handler class, assembly"
         allowDefinition="Everywhere|MachineOnly|MachineToApplication"
         allowLocation="true|false" />

Povinné atributy

Description
name Určuje název oddílu konfigurace.
type 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 ignoruje pro jiné typy aplikací.

Description
allowDefinition Určuje, ve kterém konfiguračním souboru se dá 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. Toto je výchozí hodnota.
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 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:

true
Umožňuje použití oddílu v rámci elementu <location> . Toto je výchozí hodnota.
falešný
Nepovoluje použití oddílu v rámci 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:

Prvek <section> je podřízený prvek buď <configSections> nebo <sectionGroup> ne oba.

Podřízené prvky

None

Poznámky

Deklarování oddílu konfigurace v podstatě definuje nový prvek pro konfigurační soubor. Nový prvek obsahuje nastavení, která obslužná rutina oddílu konfigurace (tj. třída, která implementuje IConfigurationSectionHandler rozhraní) přečte. Atributy a podřízené prvky oddílu, které definujete, závisí na obslužné rutině oddílu, kterou používáte ke čtení nastavení.

Deklarování obslužné rutiny oddílu konfigurace v souboru Machine.config umožňuje použít konfigurační oddíl v libovolném konfiguračním souboru aplikace v tomto počítači, pokud allowDefinition atribut neurčí jinak.

Example

Následující příklad ukazuje, jak definovat oddíl konfigurace a definovat 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 soubory, které nejsou na úrovni adresáře aplikace.

Viz také

  • Last updated on