Freigeben über


IApplicationSettingsProvider Schnittstelle

Definition

Definiert erweiterte Fähigkeiten für clientbasierte Anbieter von Anwendungseinstellungen.

public interface class IApplicationSettingsProvider
public interface IApplicationSettingsProvider
type IApplicationSettingsProvider = interface
Public 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.

Gilt für:

Weitere Informationen