LocalFileSettingsProvider Klasse
Definition
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 Persistenz für Anwendungseinstellungsklassen bereit.
public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProviderpublic class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvidertype LocalFileSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProviderPublic Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider- Vererbung
- Implementiert
Hinweise
Das Festlegen von Anbietern definiert einen Mechanismus zum Speichern von Konfigurationsdaten, die in der Anwendungseinstellungsarchitektur verwendet werden. Das .NET Framework enthält einen einzelnen Standardeinstellungsanbieter, LocalFileSettingsProvider, der Konfigurationsdaten im lokalen Dateisystem speichert. Eine Anwendungseinstellungseigenschaft oder Eine Gruppe von Eigenschaften wird einem bestimmten Einstellungsanbieter über die Verwendung der SettingsProviderAttribute.
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. So können beispielsweise viele Mitglieder ApplicationSettingsBase ihre Arbeit an den zugehörigen Einstellungsanbieter delegieren.
LocalFileSettingsProvider Speichert Einstellungen für Konfigurationsdateien, die die Erweiterung .configaufweisen. Die Inhalte von Konfigurationsdateien sind als XML-Dokumente strukturiert. Je nachdem, ob die Einstellung entweder auf Anwendungsebene oder auf Benutzerebene festgelegt ist, werden die Konfigurationsdaten als Elemente in einer <applicationSettings> oder einer <userSettings> Abschnittsgruppe gespeichert. Jede dieser Abschnittsgruppen wird durch eine entsprechende AppSettingsSection bzw ClientSettingsSection. Jedes Abschnittsobjekt gehört und wird von einem Konfigurationsabschnittshandler verwaltet, bei dem es sich um ein Objekt vom Typ handelt 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 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 Settings for Windows Forms.
Konstruktoren
| Name | Beschreibung |
|---|---|
| LocalFileSettingsProvider() |
Initialisiert eine neue Instanz der LocalFileSettingsProvider-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ApplicationName |
Dient zum Abrufen oder Festlegen des Namens der derzeit ausgeführten Anwendung. |
| Description |
Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen (UIs) geeignet ist. (Geerbt von ProviderBase) |
| Name |
Ruft den Anzeigenamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Geerbt von ProviderBase) |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient 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 Einstellungseigenschaftenwerte für die angegebene Anwendungsinstanz und die Einstellungseigenschaftsgruppe zurück. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| Initialize(String, NameValueCollection) |
Initialisiert den Anbieter. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| Reset(SettingsContext) |
Setzt alle Anwendungseinstellungseigenschaften zurück, die der angegebenen Anwendung zugeordnet sind, 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, vorherige Einstellungen mit Benutzerbereich aus einer früheren Version derselben Anwendung zu migrieren. |
