Dela via


<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>

Attribut

Beskrivning
Filen Valfritt attribut.

Anger en relativ sökväg till en extern fil som innehåller anpassade programkonfigurationsinställningar. Den angivna filen innehåller samma typ av inställningar som anges i elementen <add>, <remove> och <clear> och 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 detta den binära mappen (till exempel /bin/debug), inte platsen för programkonfigurationsfilen. För Web Forms program ä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 den vanliga språkkörningen och .NET Framework program.

Underordnade element

Description
<Add> Lägger till en anpassad programinställning.
<Tydlig> Rensar alla tidigare definierade programinställningar.
<Ta bort> Tar bort en tidigare definierad programinställning.

Kommentarer

Elementet <appSettings> lagrar information om anpassad programkonfiguration, till exempel databasanslutningssträngar, filsökvägar, URL:er för XML-webbtjänster 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 filattributet<i appSettings-elementet> iWeb.config - och programkonfigurationsfilerna. Det här attributet anger en konfigurationsfil som tillhandahåller ytterligare inställningar eller åsidosätter de inställningar som anges i elementet< appSettings>. Filattributet 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 filattributet måste ha en rotnod <med appInställningar> i stället för <konfiguration>.

Exempel

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