Teilen über


Element <appSettings> für die <Konfiguration>

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

<configuration>
  <appSettings>

Syntax

<appSettings>
  <!-- Elements to add, clear, or remove configuration settings -->
</appSettings>

attribute

BESCHREIBUNG
datei Optionales Attribut.

Gibt einen relativen Pfad zu einer externen Datei an, die benutzerdefinierte Anwendungskonfigurationseinstellungen enthält. Die angegebene Datei enthält dieselbe Art von Einstellungen, die für die Elemente <add>, <remove> und <clear> angegeben werden, und verwendet dasselbe Schlüssel-Wert-Paarformat wie diese Elemente.

Der angegebene 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-Anwendungen ist der Pfad relativ zum Anwendungsstamm, in dem sich die Datei web.config befindet.

Falls die angegebene Datei nicht gefunden wird, wird das Attribut ignoriert.

Übergeordnetes Element

Beschreibung
Element <configuration> Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.

Untergeordnete Elemente

BESCHREIBUNG
<add> Fügt eine benutzerdefinierte Anwendungseinstellung hinzu.
<clear> Löscht alle zuvor definierten Anwendungseinstellungen.
<remove> Entfernt eine zuvor definierte Anwendungseinstellung.

Bemerkungen

Das Element <appSettings> speichert benutzerdefinierte Anwendungskonfigurationsinformationen, z. B. Datenbankverbindungszeichenfolgen, Dateipfade, XML-Webdienst-URLs oder andere benutzerdefinierte Konfigurationsinformationen für eine Anwendung. Auf die im Element <appSettings> angegebenen Schlüssel-Wert-Paare wird im Code über die Klasse ConfigurationSettings zugegriffen.

Sie können das Attribut file im Element <appSettings> der Datei Web.config und in Anwendungskonfigurationsdateien verwenden. Dieses Attribut gibt eine Konfigurationsdatei an, die zusätzliche Einstellungen bereitstellt oder die im Element <appSettings> angegebenen Einstellungen überschreibt. Das Attribut file kann in Entwicklungsszenarien für das Quellcodeverwaltungsteam verwendet werden, z. B. wenn ein Benutzer die in einer Anwendungskonfigurationsdatei angegebenen Projekteinstellungen außer Kraft setzen möchte.

Konfigurationsdateien, die durch das Attribut file angegeben werden, müssen über einen Stammknoten von <appSettings> und nicht über <configuration> verfügen.

Beispiel

Das folgende Beispiel zeigt eine externe Anwendungseinstellungsdatei (custom.config), die eine benutzerdefinierte Anwendungseinstellung definiert.

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
  <add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>

Das folgende Beispiel zeigt eine Anwendungskonfigurationsdatei, die die Einstellung in der externen Einstellungsdatei verarbeitet und eine eigene Anwendungseinstellung festlegt.

<configuration>
  <appSettings file="custom.config">
    <add key="ApplicationName" value="MyApplication" />
  </appSettings>
</configuration>

Konfigurationsdatei

Dieses Element kann in der Anwendungskonfigurationsdatei, der Computerkonfigurationsdatei (Machine.config) und in Web.config-Dateien verwendet werden, die sich nicht auf der Ebene des Anwendungsverzeichnisses befinden.

Siehe auch