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 Fähigkeiten für clientbasierte Anbieter von Anwendungseinstellungen.
public interface class IApplicationSettingsProviderpublic interface IApplicationSettingsProvidertype IApplicationSettingsProvider = interfacePublic Interface IApplicationSettingsProvider- Abgeleitet
Hinweise
Mit der Architektur der Anwendungseinstellungen können Sie einen benutzerdefinierten Speichermechanismus für Anwendungseinstellungen bereitstellen, indem Sie einen benutzerdefinierten Einstellungsanbieter erstellen, bei dem es sich um eine von SettingsProviderabgeleitete Klasse handelt. 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 anbieter für benutzerdefinierte Einstellungen implementieren. Diese Schnittstelle enthält drei Methoden, die es dem Einstellungsanbieter in erster Linie ermöglichen, Änderungen der Anwendungsversion intelligenter zu behandeln. 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 Aktualisieren einer Anwendung.
Zurücksetzen der Anwendungseinstellungen auf ihre Standardwerte für die aktuell verwendete Version.
Die LocalFileSettingsProvider-Klasse implementiert die IApplicationSettingsProvider-Schnittstelle. Derselbe Satz von Methoden, die in IApplicationSettingsProvider enthalten sind, wird auch in der ApplicationSettingsBase -Klasse gefunden, die die Einrichtung eines vordefinierten Kommunikationskanals zwischen einem Anwendungseinstellungen-Wrapper und seinem Einstellungsanbieter ermöglicht.
Hinweis
Diese Schnittstelle ist optional. Wenn ein Anbieter diese Schnittstelle nicht implementiert, schlägt die Einstellungsinfrastruktur ohne Benachrichtigung fehl, wenn er versucht, auf eine der von dieser Schnittstelle definierten Methoden zuzugreifen.
Methoden
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Gibt den Wert der angegebenen Einstellungseigenschaft für die vorherige Version derselben Anwendung zurück. |
| Reset(SettingsContext) |
Setzt die mit der angegebenen Anwendung verbundenen Anwendungseinstellungen auf ihre Standardwerte zurück. |
| Upgrade(SettingsContext, SettingsPropertyCollection) |
Gibt dem Anbieter an, dass die Anwendung aktualisiert wurde. Dadurch erhält der Anbieter die Gelegenheit, seine gespeicherten Einstellungen entsprechend zu aktualisieren. |
