<het element appSettings> voor <configuratie>
Bevat aangepaste toepassingsinstellingen. Dit is een vooraf gedefinieerde configuratiesectie die wordt geleverd door de .NET Framework.
<configuratie>
<appSettings>
Syntax
<appSettings>
<!-- Elements to add, clear, or remove configuration settings -->
</appSettings>
Kenmerk
| Beschrijving | |
|---|---|
| Bestand | Optioneel kenmerk. Hiermee geeft u een relatief pad naar een extern bestand met aangepaste toepassingsconfiguratie-instellingen. Het opgegeven bestand bevat dezelfde soort instellingen die zijn opgegeven in de <elementen toevoegen>, <verwijderen> en <wissen> en gebruikt dezelfde sleutel-waardepaarindeling als deze elementen. Het opgegeven pad is relatief ten opzichte van het hoofdconfiguratiebestand. Voor een Windows Forms toepassing is dit de binaire map (zoals /bin/debug), niet de locatie van het configuratiebestand van de toepassing. Voor Web Forms toepassingen is het pad relatief ten opzichte van de hoofdmap van de toepassing, waar het web.config-bestand zich bevindt. De runtime negeert het kenmerk als het opgegeven bestand niet kan worden gevonden. |
Bovenliggend element
| Beschrijving | |
|---|---|
| <configuratie-element> | Het hoofdelement in elk configuratiebestand dat wordt gebruikt door de common language runtime en .NET Framework toepassingen. |
Onderliggende elementen
| Beschrijving | |
|---|---|
| <Toevoegen> | Hiermee wordt een aangepaste toepassingsinstelling toegevoegd. |
| <Duidelijk> | Wist alle eerder gedefinieerde toepassingsinstellingen. |
| <Verwijderen> | Hiermee verwijdert u een eerder gedefinieerde toepassingsinstelling. |
Opmerkingen
Het <element appSettings> slaat aangepaste toepassingsconfiguratiegegevens op, zoals databaseverbindingsreeksen, bestandspaden, XML-webservice-URL's of andere aangepaste configuratiegegevens voor een toepassing. De sleutel-waardeparen die zijn opgegeven in het <element appSettings> , worden in code geopend met behulp van de ConfigurationSettings klasse .
U kunt het bestandskenmerk gebruiken in het <element appSettings> van de Web.config - en toepassingsconfiguratiebestanden. Met dit kenmerk wordt een configuratiebestand opgegeven dat aanvullende instellingen biedt of de instellingen overschrijft die zijn opgegeven in het <element appSettings> . Het bestandskenmerk kan worden gebruikt in scenario's voor het ontwikkelen van broncodebeheerteams, bijvoorbeeld wanneer een gebruiker de projectinstellingen wil overschrijven die zijn opgegeven in een toepassingsconfiguratiebestand.
Configuratiebestanden die zijn opgegeven door het bestandskenmerk, moeten een hoofdknooppunt van appSettings> hebben in plaats van< configuratie>.<
Voorbeeld
In het volgende voorbeeld ziet u een bestand met externe toepassingsinstellingen (custom.config) waarmee een aangepaste toepassingsinstelling wordt gedefinieerd:
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>
In het volgende voorbeeld ziet u een toepassingsconfiguratiebestand dat de instelling in het bestand met externe instellingen gebruikt en een eigen toepassingsinstelling instelt:
<configuration>
<appSettings file="custom.config">
<add key="ApplicationName" value="MyApplication" />
</appSettings>
</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.
