add-Element für appSettings (allgemeines Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
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 sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
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. |
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
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 |
|
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physischer 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
Referenz
appSettings-Element (allgemeines Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
clear-Element für appSettings (allgemeines Einstellungsschema)
remove-Element für appSettings (allgemeines Einstellungsschema)
Konzepte
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)