LocalFileSettingsProvider Klasse

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

LocalFileSettingsProvider.cs

Stellt Dauerhaftigkeit Klassen für Anwendungseinstellungsklassen bereit.

public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider

public class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider

type LocalFileSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider

Public Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider

Vererbung

Object

ProviderBase

SettingsProvider

LocalFileSettingsProvider

Implementiert

IApplicationSettingsProvider

Hinweise

Festlegen von Anbietern definieren einen Mechanismus zum Speichern von Konfigurationsdaten, die in der Anwendungseinstellungsarchitektur verwendet werden. Die .NET Framework enthält einen einzelnen Standardeinstellungsanbieter, LocalFileSettingsProviderder Konfigurationsdaten im lokalen Dateisystem speichert. Eine Anwendungseinstellungseigenschaft oder Eine Gruppe von Eigenschaften wird einem bestimmten Einstellungsanbieter durch die Verwendung von SettingsProviderAttributezugeordnet.

In der Regel greift das Clientprogramm nicht explizit auf diese Klasse zu. Vielmehr ruft die Architektur der Anwendungseinstellungen automatisch den entsprechenden Einstellungsanbieter auf, wenn dessen Dienste erforderlich sind. Beispielsweise delegieren viele Mitglieder ihre ApplicationSettingsBase Arbeit an den zugehörigen Einstellungsanbieter.

LocalFileSettingsProvider Behält Einstellungen für Konfigurationsdateien mit der Erweiterung .configbei. Die Inhalte von Konfigurationsdateien sind als XML-Dokumente strukturiert. Je nachdem, ob die Einstellung des auf der Anwendungsebene oder Benutzerebene festgelegt ist, befindet sich die Konfigurationsdaten werden als Elemente innerhalb einer <applicationSettings> oder ein <userSettings> Abschnittsgruppe bzw. Jede dieser Abschnittsgruppen wird dargestellt, von einer entsprechenden AppSettingsSection oder ClientSettingsSectionbzw. Jeder Abschnittsobjekt im Besitz und verwaltet einen Konfigurationsabschnittshandler, die ein Objekt des Typs ist IConfigurationSectionHandler.

Anwendungsbezogene Einstellungen und die Standardeinstellungen für den Benutzerbereich werden in einer Datei mit dem Namen application.exe.configgespeichert, die im selben Verzeichnis wie die ausführbare Datei erstellt wird. Anwendungskonfigurationseinstellungen sind schreibgeschützt. Bestimmte Benutzerdaten werden in einer Datei mit dem Namen user.configgespeichert, die unter dem Basisverzeichnis des Benutzers gespeichert wird. Wenn Roamingprofile aktiviert sind, können zwei Versionen der Benutzerkonfigurationsdatei vorhanden sein. In einem solchen Fall haben die Einträge in der Roamingversion Vorrang vor doppelten Einträgen in der lokalen Benutzerkonfigurationsdatei.

Weitere Informationen zu Anwendungseinstellungen finden Sie unter Anwendungseinstellungen für Windows Forms.

Konstruktoren

LocalFileSettingsProvider()

Initialisiert eine neue Instanz der LocalFileSettingsProvider-Klasse.

Eigenschaften

ApplicationName	Ruft den Namen der aktuell ausgeführten Anwendung ab oder legt diesen fest.
Description	Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen geeignet ist. (Geerbt von ProviderBase)
Name	Ruft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Geerbt von ProviderBase)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPreviousVersion(SettingsContext, SettingsProperty)	Gibt den Wert der benannten Einstellungseigenschaft für die vorherige Version derselben Anwendung zurück.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Gibt die Auflistung der Einstellungseigenschaftswerte für die angegebene Anwendungsinstanz und Einstellungseigenschaftengruppe zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize(String, NameValueCollection)	Initialisiert den Anbieter.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Reset(SettingsContext)	Setzt alle mit der angegebenen Anwendung verbundenen Anwendungseinstellungseigenschaften auf ihre Standardwerte zurück.
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	Legt die Werte der angegebenen Gruppe von Eigenschafteneinstellungen fest.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Upgrade(SettingsContext, SettingsPropertyCollection)	Versucht, frühere, den Benutzer betreffende Einstellungen aus einer früheren Version derselben Anwendung zu migrieren.

Weitere Informationen

• SettingsProviderAttribute
• ApplicationScopedSettingAttribute
• UserScopedSettingAttribute
• ApplicationSettingsBase
• ClientSettingsSection
• IConfigurationSectionHandler
• Architektur der Anwendungseinstellungen