<element appSettings> pro <konfiguraci>
Obsahuje vlastní nastavení aplikace. Toto je předdefinovaná část konfigurace poskytovaná rozhraním .NET Framework.
<Konfigurace>
<Appsettings>
Syntax
<appSettings>
<!-- Elements to add, clear, or remove configuration settings -->
</appSettings>
Atribut
Popis | |
---|---|
Soubor | Nepovinný atribut. Určuje relativní cestu k externímu souboru obsahujícímu vlastní nastavení konfigurace aplikace. Zadaný soubor obsahuje stejný druh nastavení, která jsou zadána v <elementech přidat>, <odebrat> a <vymazat> , a používá stejný formát páru klíč/hodnota jako tyto prvky. Zadaná cesta je relativní k hlavnímu konfiguračnímu souboru. U model Windows Forms aplikace se jedná o binární složku (například /bin/debug), nikoli o umístění konfiguračního souboru aplikace. U Web Forms aplikací je cesta relativní ke kořenovému adresáři aplikace, kde se nachází souborweb.config. Modul runtime ignoruje atribut, pokud zadaný soubor nelze najít. |
Nadřazený element
Description | |
---|---|
<configuration> – element | Kořenový prvek v každém konfiguračním souboru, který je používán modulem Common Language Runtime (CLR) a aplikacemi rozhraní .NET Framework. |
Podřízené prvky
Description | |
---|---|
<Přidat> | Přidá vlastní nastavení aplikace. |
<Jasné> | Vymaže všechna dříve definovaná nastavení aplikace. |
<Odebrat> | Odebere dříve definované nastavení aplikace. |
Poznámky
Element <appSettings> ukládá informace o vlastní konfiguraci aplikace, jako jsou připojovací řetězce databáze, cesty k souborům, adresy URL webové služby XML nebo jakékoli jiné informace o vlastní konfiguraci pro aplikaci. Páry klíč/hodnota zadané v elementu <appSettings> jsou přístupné v kódu pomocí ConfigurationSettings třídy .
Atribut file můžete použít v elementu <appSettings> konfiguračních souborůWeb.config a aplikace. Tento atribut určuje konfigurační soubor, který poskytuje další nastavení nebo přepíše nastavení zadaná v elementu< appSettings>. Atribut file lze použít ve scénářích vývoje týmu správy zdrojového kódu, například když uživatel chce přepsat nastavení projektu zadané v konfiguračním souboru aplikace.
Konfigurační soubory určené atributem file musí místo konfigurace> obsahovat kořenový uzel appSettings<>.<
Příklad
Následující příklad ukazuje soubor nastavení externí aplikace (custom.config), který definuje vlastní nastavení aplikace:
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>
Následující příklad ukazuje konfigurační soubor aplikace, který využívá nastavení v souboru externího nastavení a nastaví vlastní nastavení aplikace:
<configuration>
<appSettings file="custom.config">
<add key="ApplicationName" value="MyApplication" />
</appSettings>
</configuration>
Konfigurační soubor
Tento prvek lze použít v konfiguračním souboru aplikace, konfiguračním souboru počítače (Machine.config) a Web.config souborech, které nejsou na úrovni adresáře aplikace.