<appSettings> element för <konfiguration>

Innehåller anpassade programinställningar. Det här är ett fördefinierat konfigurationsavsnitt som tillhandahålls av .NET Framework.

<konfiguration>
   <appSettings>

Syntax

<appSettings>
  <!-- Elements to add, clear, or remove configuration settings -->
</appSettings>

Attribute

Description

file

Valfritt attribut. Anger en relativ sökväg till en extern fil som innehåller konfigurationsinställningar för anpassade program. Den angivna filen innehåller samma typ av inställningar som anges i elementen <add>, <remove>och och <clear> använder samma nyckel/värde-parformat som dessa element. Den angivna sökvägen är relativ till huvudkonfigurationsfilen. För ett Windows Forms-program är det här binärmappen (till exempel /bin/debug), inte platsen för programkonfigurationsfilen. För webbformulärprogram är sökvägen relativ till programroten, där denweb.config filen finns. Körningen ignorerar attributet om den angivna filen inte kan hittas.

Överordnat element

	Description
<configuration> Element	Rotelementet i varje konfigurationsfil som används av vanliga språkkörnings- och .NET Framework-program.

Underordnade element

	Description
<addera>	Lägger till en anpassad programinställning.
<klar>	Rensar alla tidigare definierade programinställningar.
<avlägsna>	Tar bort en tidigare definierad programinställning.

Anmärkningar

Elementet <appSettings> lagrar konfigurationsinformation för anpassade program, till exempel databasanslutningssträngar, filsökvägar, XML-webbtjänst-URL:er eller annan anpassad konfigurationsinformation för ett program. Nyckel/värde-paren som anges i elementet <appSettings> används i kod med hjälp av ConfigurationSettings klassen .

Du kan använda file attributet i elementet <appSettings> iWeb.config - och programkonfigurationsfilerna. Det här attributet anger en konfigurationsfil som ger ytterligare inställningar eller åsidosätter de inställningar som anges i elementet <appSettings> . Attributet file kan användas i utvecklingsscenarier för källkontrollteamet, till exempel när en användare vill åsidosätta de projektinställningar som anges i en programkonfigurationsfil.

Konfigurationsfiler som anges av file attributet måste ha en rotnod i <appSettings> stället <configuration>för .

Example

I följande exempel visas en extern programinställningsfil (custom.config) som definierar en anpassad programinställning:

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
  <add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>

I följande exempel visas en programkonfigurationsfil som använder inställningen i den externa inställningsfilen och anger en egen programinställning:

<configuration>
  <appSettings file="custom.config">
    <add key="ApplicationName" value="MyApplication" />
  </appSettings>
</configuration>

Konfigurationsfil

Det här elementet kan användas i programkonfigurationsfilen, datorkonfigurationsfilen (Machine.config) och Web.config filer som inte finns på programkatalognivå.

Se även

• Konfigurationsfilschema för .NET Framework