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