Sdílet prostřednictvím


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

Viz také