<section> elem

Konfigurációs szakasz deklarációját tartalmazza.

<configuration>
  <configSections>
    <section>

<configuration>
  <configSections>
    <sectionGroup>
      <section>

Szemantika

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

Szükséges attribútumok

Attribute Description
name Megadja a konfigurációs szakasz nevét.
type Megadja annak a konfigurációs szakaszkezelő osztálynak a nevét, amely beolvassa a szakaszt a konfigurációs fájlból. A típus értéke a következő szintaxissal rendelkezik: "teljes körűen minősített szakasz-kezelő-osztálynév, egyszerű-szerelvény-név". Az egyszerű szerelvénynév a .dllfájlkiterjesztés nélküli gyökérfájlnév.

Választható attribútumok

Az alábbi attribútumok csak ASP.NET alkalmazásokra vonatkoznak. A konfigurációs rendszer figyelmen kívül hagyja ezeket az attribútumokat más alkalmazástípusok esetében.

Nem kötelező attribútum Description
allowDefinition Megadja, hogy a szakasz mely konfigurációs fájlban használható. Használja az alábbi értékek egyikét:

Mindenhol
Lehetővé teszi a szakasz bármely konfigurációs fájlban való használatát. Ez az alapértelmezett érték.
MachineOnly
A szakasz csak a gép konfigurációs fájljában (Machine.config) használható.
MachineToApplication
Engedélyezi a szakasz használatát a gép konfigurációs fájljában vagy az alkalmazáskonfigurációs fájlban.
allowLocation Meghatározza, hogy a szakasz használható-e az elemen <location> belül. Használja az alábbi értékek egyikét:

igaz
Lehetővé teszi a szakasz elemen belüli <location> használatát. Ez az alapértelmezett érték.
téves
Nem engedélyezi a szakasz használatát az elemen <location> belül.

Szülőelemek

Szülőelem Description
<configSections> Konfigurációs szakaszt és névtérdeklarációkat tartalmaz.
<sectionGroup> A konfigurációs szakaszok névterét határozza meg.

Megjegyzés:

Az <section> elem vagy mindkettő <configSections><sectionGroup> gyermekeleme, de nem mindkettő.

Gyermekelemek

None

Megjegyzések

A konfigurációs szakasz deklarálása lényegében egy új elemet határoz meg a konfigurációs fájlhoz. Az új elem olyan beállításokat tartalmaz, amelyeket egy konfigurációs szakasz kezelője (vagyis az interfészt megvalósító IConfigurationSectionHandler osztály) olvas be. A megadott szakasz attribútumai és gyermekelemei a beállítások olvasásához használt szakaszkezelőtől függnek.

A konfigurációs szakasz kezelőjének deklarálása a Machine.config fájlban lehetővé teszi a konfigurációs szakasz használatát a számítógépen található alkalmazáskonfigurációs fájlokban, kivéve, ha az allowDefinition attribútum másként rendelkezik.

Example

Az alábbi példa bemutatja, hogyan definiálhat egy konfigurációs szakaszt, és hogyan határozhatja meg az adott szakasz beállításait:

<configuration>
  <configSections>
    <section name="sampleSection"
             type="System.Configuration.SingleTagSectionHandler"
             allowLocation="false" />
  </configSections>
  <sampleSection setting1="Value1"
                 setting2="value two"
                 setting3="third value" />
</configuration>

Konfigurációs fájl

Ez az elem használható az alkalmazáskonfigurációs fájlban, a gépkonfigurációs fájlban (Machine.config) és Web.config olyan fájlokban, amelyek nem az alkalmazás könyvtárszintjén találhatók.

Lásd még

  • Last updated on