Podelement add elementu appSettings (Obecné schéma nastavení)

Článek
08/11/2011

Přidá vlastní nastavení aplikace do kolekce nastavení aplikace ve tvaru dvojice klíč/hodnota.

<add
   key="String name"
   value="String value"
/>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
key	Požadované String atributu. Určuje název nastavení aplikace. Tento atribut je klíč kolekce.
value	Požadovaný atribut typu String. Určuje hodnotu nastavení aplikace.
Zděděné atributy	Volitelné atributy. Atributy, které jsou děděny všemi prvky oddílu. Další informace naleznete v tématu Obecné atributy, které jsou děděny všemi prvky oddílu.

key

Požadované String atributu.

Určuje název nastavení aplikace. Tento atribut je klíč kolekce.

value

Požadovaný atribut typu String.

Určuje hodnotu nastavení aplikace.

Zděděné atributy

Volitelné atributy.

Atributy, které jsou děděny všemi prvky oddílu. Další informace naleznete v tématu Obecné atributy, které jsou děděny všemi prvky oddílu.

Podřízené prvky

Žádný

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.
appSettings	Obsahuje nastavení vlastní aplikace, jako například cesty k souborům, adresy URL webových služeb XML a další informace, které jsou uloženy v souboru INI pro jednotlivé aplikace.

Poznámky

Element add přidá vlastní nastavení aplikace jako dvojici název/hodnota do kolekce zděděných nastavení aplikace v elementu appSettings.

Důležité
Klíče musí být jedinečný.Přidat více položek se stejným klíčem poslední položka zachována.

Element appSettings ukládá informace o konfiguraci vlastní aplikace, jako například cesty k souborům, adresy URL webových služeb XML nebo jakékoli jiné informace, které jsou uloženy v souboru INI pro jednotlivé aplikace. Dvojice klíče a hodnoty určené v appSettings prvku lze získat přístup pomocí kódu ConfigurationSettings Třída Příklad třídy ukazuje, jak přistupovat appSettings programově.

Výchozí konfigurace

Následující výchozí appSettings prvek nastaven v souboru Machine.config v.NET Framework verze 1.0 a 1.1.

<appSettings>
        <add key="XML File Name" value="myXmlFileName.xml" /> 
    </appSettings>

Příklad

Konfigurační soubory, které jsou určeny v atributu file, musí mít jako kořenový prvek spíše element appSettings než element configuration. Následující kód je správný pro konfigurační soubor, který je určen v atributu file.

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>

Následující příklad kódu ukazuje, jak definovat vlastní nastavení aplikace v konfiguračním souboru.

<configuration>
    <appSettings>
        <add key="Application Name" value="MyApplication" />
    </appSettings>
</configuration>

Informace prvku

Obslužná rutina konfiguračního oddílu	AppSettingsSection
Konfigurační člen	Add
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework, verze 1.0, 1.1 nebo 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím