LocalFileSettingsProvider Klasse

Referenz

Definition

Namespace:: System.Configuration

Assembly:: System.Configuration.ConfigurationManager.dll

Assembly:: System.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Durch Festlegen von Anbietern wird ein Mechanismus zum Speichern von Konfigurationsdaten definiert, die in der Architektur der Anwendungseinstellungen verwendet werden. Die .NET Framework enthält einen einzigen Standardeinstellungsanbieter, LocalFileSettingsProviderder Konfigurationsdaten im lokalen Dateisystem speichert. Eine Eigenschaft oder Eine Gruppe von Eigenschaften für Anwendungseinstellungen ist einem bestimmten Einstellungsanbieter über die Verwendung des SettingsProviderAttributezugehörigen Einstellungsanbieters zugeordnet.

In der Regel greift das Clientprogramm nicht explizit auf diese Klasse zu; Stattdessen ruft die Architektur der Anwendungseinstellungen automatisch den entsprechenden Einstellungsanbieter auf, wenn seine Dienste erforderlich sind. Viele der Mitglieder des Delegierens ApplicationSettingsBase ihrer Arbeit an den zugehörigen Einstellungsanbieter beispielsweise.

LocalFileSettingsProvider Speichert Einstellungen für Konfigurationsdateien, die über die Erweiterung .configverfügen. Der Inhalt der Konfigurationsdateien ist 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 standardmäßigen Benutzerbereichseinstellungen werden in einer Datei mit dem Namen " application.exe.configName" gespeichert, 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" gespeichert, die im Startverzeichnis des Benutzers gespeichert ist. Wenn Roamingprofile aktiviert sind, können zwei Versionen der Benutzerkonfigurationsdatei vorhanden sein. In diesem Fall haben die Einträge in der Roamingversion Vorrang vor doppelten Einträgen in der lokalen Benutzerkonfigurationsdatei.

Weitere Informationen zu Anwendungseinstellungen finden Sie unter Application Einstellungen 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.

Gilt für