<appSettings>-Element

Artikel
03/31/2008

Enthält benutzerdefinierte Anwendungseinstellungen. Dies ist ein vordefinierter Konfigurationsabschnitt, der von .NET Framework bereitgestellt wird.

<configuration>
** <appSettings>**

<appSettings file="relative file name">
</appSettings>

Optionales Attribut

Attribut	Beschreibung
file	Gibt einen relativen Pfad für eine externe Datei an, die benutzerdefinierte Einstellungen für die Anwendungskonfiguration enthält. Die angegebene Datei enthält die gleiche Art von Einstellungen, die im <add>-Element, <remove>-Element und <clear>-Element angegeben sind, und verwendet das gleiche Format aus Schlüssel-Wert-Paar wie diese Elemente. Der Pfad ist relativ zur Hauptkonfigurationsdatei. Bei einer Windows Forms-Anwendung ist dies der Binärordner (z. B. /bin/debug), nicht der Speicherort der Anwendungskonfigurationsdatei. Bei Web Forms-Anwendung ist der Pfad relativ zum Anwendungsstamm, wo sich die Datei web.config befindet. Beachten Sie, dass die Laufzeit das Attribut ignoriert, wenn die angegebene Datei nicht gefunden werden kann.

file

Gibt einen relativen Pfad für eine externe Datei an, die benutzerdefinierte Einstellungen für die Anwendungskonfiguration enthält. Die angegebene Datei enthält die gleiche Art von Einstellungen, die im <add>-Element, <remove>-Element und <clear>-Element angegeben sind, und verwendet das gleiche Format aus Schlüssel-Wert-Paar wie diese Elemente.

Der Pfad ist relativ zur Hauptkonfigurationsdatei. Bei einer Windows Forms-Anwendung ist dies der Binärordner (z. B. /bin/debug), nicht der Speicherort der Anwendungskonfigurationsdatei. Bei Web Forms-Anwendung ist der Pfad relativ zum Anwendungsstamm, wo sich die Datei web.config befindet.

Beachten Sie, dass die Laufzeit das Attribut ignoriert, wenn die angegebene Datei nicht gefunden werden kann.

Untergeordnete Elemente

Element	Beschreibung
<add>	Fügt benutzerdefinierte Anwendungseinstellungen hinzu.
<remove>	Entfernt eine zuvor definierte Anwendungseinstellung.
<clear>	Entfernt alle zuvor definierten Anwendungseinstellungen.

Hinweise

Das <appSettings>-Element speichert benutzerdefinierte Anwendungskonfigurationsinformationen wie Datenbank-Verbindungszeichenfolgen, Dateipfade, XML-Webdienst-URLs oder sonstige Informationen, die in der INI-Datei einer Anwendung gespeichert sind. Der Zugriff auf die <appSettings>-Element angegebenen Schlüssel-Wert-Paare erfolgt im Code über die System.Configuration.ConfigurationSettings-Klasse.

Sie können das file-Attribut im <appSettings>-Element der Datei Web.config und der Anwendungskonfigurationsdateien verwenden. Mit diesem Attribut wird eine Konfigurationsdatei angegeben, die zusätzliche Einstellungen bereitstellt oder die im <appSettings>-Element angegebenen Einstellungen überschreibt. Das file-Attribut kann in Teamentwicklerszenarien mit Quellcodeverwaltung verwendet werden, wenn ein Benutzer die in einer Anwendungskonfigurationsdatei angegebenen Projekteinstellungen überschreiben möchte.

Durch das file-Attribut angegebene Konfigurationsdateien müssen <appSettings> anstelle von <configuration> als Stammknoten besitzen. 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>

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie eine benutzerdefinierte Anwendungseinstellung in einer Konfigurationsdatei festlegen.

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

Konfigurationsdatei

Dieses Element kann in der Konfigurationsdatei der Anwendung, der Konfigurationsdatei des Computers (Machine.config) und in den Web.config-Dateien verwendet werden, die sich nicht auf Anwendungsverzeichnisebene befinden.

Siehe auch

Schema für Konfigurationsabschnitte | Einstellungen für Konfigurationsabschnitte

Share via