add-Element für appSettings (allgemeines Einstellungsschema)

Artikel
08/10/2011

Fügt eine benutzerdefinierte Anwendungseinstellung in Form eines Name-Wert-Paars zur Auflistung der Anwendungseinstellungen hinzu.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribute	Beschreibung
key	Erforderliches String-Attribut. Gibt den Namen der Anwendungseinstellung an. Dieses Attribut ist der Auflistungsschlüssel.
value	Erforderliches String-Attribut. Gibt den Wert der Anwendungseinstellung an.
Geerbte Attribute	Optionale Attribute. Attribute, die von allen Abschnittselementen geerbt werden. Weitere Informationen finden Sie unter Von Abschnittselementen geerbte allgemeine Attribute.

key

Erforderliches String-Attribut.

Gibt den Namen der Anwendungseinstellung an. Dieses Attribut ist der Auflistungsschlüssel.

value

Erforderliches String-Attribut.

Gibt den Wert der Anwendungseinstellung an.

Geerbte Attribute

Optionale Attribute.

Attribute, die von allen Abschnittselementen geerbt werden. Weitere Informationen finden Sie unter Von Abschnittselementen geerbte allgemeine Attribute.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibungen
configuration	Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
system.web	Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an und enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.
appSettings	Enthält benutzerdefinierte Anwendungseinstellungen wie Dateipfade, XML-Webdienst-URLs oder sonstige Informationen, die in der INI-Datei einer Anwendung gespeichert sind.

Hinweise

Das add-Element fügt eine benutzerdefinierte Anwendungseinstellung in Form eines Name-Wert-Paars zur Auflistung der Anwendungseinstellungen im appSettings-Element hinzu.

Wichtig
Die Schlüssel müssen eindeutig sein.Wenn Sie mehrere Einträge mit demselben Schlüssel hinzufügen, wird nur der letzte Eintrag beibehalten.

Das appSettings-Element enthält benutzerdefinierte Anwendungskonfigurationsinformationen wie Dateipfade, XML-Webdienst-URLs oder sonstige Informationen, die in der INI-Datei einer Anwendung gespeichert sind. Der Zugriff auf die im appSettings-Element angegebenen Schlüssel-Wert-Paare erfolgt im Code über die ConfigurationSettings-Klasse. Das Klassenbeispiel zeigt, wie auf appSettings programmgesteuert zugegriffen wird.

Standardkonfiguration

Das folgende appSettings-Standardelement wird in der Datei Machine.config in .NET Framework, Version 1.0 und 1.1, konfiguriert.

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

Beispiel

In file-Attributen angegebene Konfigurationsdateien müssen appSettings und nicht configuration als Stammknoten haben. Der folgende Code ist bei einer mit dem file-Attribut angegebenen Konfigurationsdatei korrekt:

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

Das folgende Codebeispiel veranschaulicht, wie Sie eine benutzerdefinierte Anwendungseinstellung in einer Konfigurationsdatei definieren.

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

Elementinformationen

Konfigurationsabschnittshandler	AppSettingsSection
Konfigurationsmember	Add
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physikalischer Verzeichnisse
Anforderungen	Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 1.0, 1.1 oder 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch