<sectie-element>
Bevat een configuratiesectiedeclaratie.
<configuratie>
<configSections>
<Sectie>
<configuratie>
<configSections>
<sectionGroup>
<Sectie>
Syntax
<section name="section name"
type="configuration section handler class, assembly"
allowDefinition="Everywhere|MachineOnly|MachineToApplication"
allowLocation="true|false" />
Vereiste kenmerken
| Beschrijving | |
|---|---|
| name | Hiermee geeft u de naam van de configuratiesectie. |
| type | Hiermee geeft u de naam op van de handlerklasse van de configuratiesectie die de sectie uit het configuratiebestand leest. De typewaarde heeft de syntaxis 'fully-qualified-section-handler-class-name, simple-assembly-name'. De eenvoudige assemblynaam is de hoofdbestandsnaam zonder de bestandsextensie .dll . |
Optionele kenmerken
De volgende kenmerken zijn alleen van toepassing op ASP.NET toepassingen. Het configuratiesysteem negeert deze kenmerken voor andere toepassingstypen.
| Beschrijving | |
|---|---|
| allowDefinition | Hiermee geeft u op in welk configuratiebestand de sectie kan worden gebruikt. Gebruik een van de volgende waarden: Overal Hiermee staat u toe dat de sectie wordt gebruikt in een configuratiebestand. Dit is de standaardinstelling. MachineOnly Hiermee staat u toe dat de sectie alleen wordt gebruikt in het configuratiebestand van de machine (Machine.config). MachineToApplication Hiermee staat u toe dat de sectie wordt gebruikt in het configuratiebestand van de machine of het configuratiebestand van de toepassing. |
| allowLocation | Bepaalt of de sectie kan worden gebruikt binnen het <locatie-element> . Gebruik een van de volgende waarden: Waar Hiermee staat u toe dat de sectie wordt gebruikt binnen het <locatie-element> . Dit is de standaardinstelling. Valse Hiermee staat u niet toe dat de sectie wordt gebruikt binnen het <locatie-element> . |
Bovenliggende elementen
| Beschrijving | |
|---|---|
| <het element configSections> | Bevat configuratiesectie- en naamruimtedeclaraties. |
| <sectionGroup-element> | Definieert een naamruimte voor configuratiesecties. |
Notitie
Een <sectie-element> is een onderliggend element van <configSections> of <sectionGroup> , maar niet beide.
Onderliggende elementen
Geen
Opmerkingen
Als u een configuratiesectie declareren, wordt in feite een nieuw element voor het configuratiebestand gedefinieerd. Het nieuwe element bevat instellingen die worden gelezen door een handler voor configuratiesecties (een klasse die de IConfigurationSectionHandler interface implementeert). De kenmerken en onderliggende elementen van een sectie die u definieert, zijn afhankelijk van de sectie-handler die u gebruikt om uw instellingen te lezen.
Door een configuratiesectie-handler in het Machine.config-bestand te declareren, kunt u de configuratiesectie gebruiken in een toepassingsconfiguratiebestand op die computer, tenzij het kenmerk allowDefinition anders aangeeft.
Voorbeeld
In het volgende voorbeeld ziet u hoe u een configuratiesectie definieert en instellingen voor die sectie definieert:
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler"
allowLocation="false" />
</configSections>
<sampleSection setting1="Value1"
setting2="value two"
setting3="third value" />
</configuration>
Configuratiebestand
Dit element kan worden gebruikt in het configuratiebestand van de toepassing, het computerconfiguratiebestand (Machine.config) en Web.config bestanden die zich niet op het niveau van de toepassingsmap bevinden.
