Freigeben über

<appSettings> Element für die <Konfiguration>

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

<Konfiguration>
   <appSettings>

Syntax

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

Merkmal

Description
file Optionales Attribut.

Gibt einen relativen Pfad zu einer externen Datei an, die benutzerdefinierte Anwendungskonfigurationseinstellungen enthält. Die angegebene Datei enthält die gleiche Art von Einstellungen, die in den <add>Elementen <remove>und <clear> Elementen angegeben sind und dasselbe Schlüssel-Wert-Paarformat wie diese Elemente verwenden.

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

Die Laufzeit ignoriert das Attribut, wenn die angegebene Datei nicht gefunden werden kann.

Übergeordnetes Element

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

Untergeordnete Elemente

Description
<hinzufügen> Fügt eine benutzerdefinierte Anwendungseinstellung hinzu.
<klar> Löscht alle zuvor definierten Anwendungseinstellungen.
<entfernen> Entfernt eine zuvor definierte Anwendungseinstellung.

Bemerkungen

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

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

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

Example

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 Datei für externe Einstellungen verwendet und eine eigene Anwendungseinstellung festlegt:

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

Konfigurationsdatei

Dieses Element kann in der Anwendungskonfigurationsdatei, computerkonfigurationsdatei (Machine.config) und Web.config Dateien verwendet werden, die sich nicht auf Anwendungsverzeichnisebene befinden.

Siehe auch

  • Last updated on