IApplicationSettingsProvider Schnittstelle
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.
Definiert erweiterte Funktionen für clientbasierte Anwendungseinstellungsanbieter.
public interface class IApplicationSettingsProviderpublic interface IApplicationSettingsProvidertype IApplicationSettingsProvider = interfacePublic Interface IApplicationSettingsProvider- Abgeleitet
Hinweise
Mithilfe der Anwendungseinstellungsarchitektur können Sie einen benutzerdefinierten Speichermechanismus für Anwendungseinstellungen bereitstellen, indem Sie einen benutzerdefinierten Einstellungsanbieter erstellen, der von einer klasse abgeleitet wird SettingsProvider. Eine solche Klasse enthält die grundlegenden Funktionen zum Speichern und Abrufen von Eigenschaften. Sie können jedoch zusätzliche standardisierte Funktionen hinzufügen, indem Sie die IApplicationSettingsProvider Schnittstelle im benutzerdefinierten Einstellungsanbieter implementieren. Diese Schnittstelle enthält drei Methoden, mit denen der Einstellungsanbieter in erster Linie Anwendungsversionsänderungen intelligenter behandeln kann. In der Regel speichert der Einstellungsanbieter Anwendungseinstellungen für verschiedene Versionen einer Anwendung separat, um die folgenden Umstände zu antizipieren:
Parallele Ausführung verschiedener Versionen einer Anwendung.
Beibehalten von Anwendungseinstellungen beim Upgrade einer Anwendung.
Zurücksetzen der Anwendungseinstellungen auf ihre Standardwerte für die aktuell verwendete Version.
Der LocalFileSettingsProvider-Klasse implementiert die IApplicationSettingsProvider-Schnittstelle. Derselbe Satz von Methoden, die enthalten IApplicationSettingsProvider sind, befindet sich auch in der ApplicationSettingsBase Klasse und ermöglicht die Einrichtung eines vordefinierten Kommunikationskanals zwischen einem Anwendungseinstellungswrapper und seinem Einstellungsanbieter.
Note
Diese Schnittstelle ist optional. Wenn ein Anbieter diese Schnittstelle nicht implementiert, schlägt die Einstellungsinfrastruktur ohne Benachrichtigung fehl, wenn versucht wird, auf eine der von dieser Schnittstelle definierten Methoden zuzugreifen.
Methoden
| Name | Beschreibung |
|---|---|
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Gibt den Wert der angegebenen Einstellungseigenschaft für die vorherige Version derselben Anwendung zurück. |
| Reset(SettingsContext) |
Setzt die Anwendungseinstellungen zurück, die der angegebenen Anwendung zugeordnet sind, auf ihre Standardwerte zurück. |
| Upgrade(SettingsContext, SettingsPropertyCollection) |
Gibt an, dass der Anbieter, für den die Anwendung aktualisiert wurde. Dies bietet dem Anbieter die Möglichkeit, die gespeicherten Einstellungen entsprechend zu aktualisieren. |
