Udostępnij za pośrednictwem


IApplicationSettingsProvider Interfejs

Definicja

Definiuje rozszerzone możliwości dla dostawców ustawień aplikacji opartych na kliencie.

public interface class IApplicationSettingsProvider
public interface IApplicationSettingsProvider
type IApplicationSettingsProvider = interface
Public Interface IApplicationSettingsProvider
Pochodne

Uwagi

Architektura ustawień aplikacji umożliwia zapewnienie niestandardowego mechanizmu magazynu dla ustawień aplikacji przez utworzenie dostawcy ustawień niestandardowych, który jest klasą pochodną SettingsProvider. Taka klasa zawiera podstawowe funkcje przechowywania i pobierania właściwości. Można jednak dodać dodatkową ustandaryzowaną funkcjonalność, implementując IApplicationSettingsProvider interfejs u dostawcy ustawień niestandardowych. Ten interfejs zawiera trzy metody, które przede wszystkim umożliwiają dostawcy ustawień bardziej inteligentną obsługę zmian wersji aplikacji. Zazwyczaj dostawca ustawień będzie przechowywać ustawienia aplikacji dla różnych wersji aplikacji oddzielnie, aby przewidzieć następujące okoliczności:

  • Wykonywanie równoległe różnych wersji aplikacji.

  • Zachowywanie ustawień aplikacji podczas uaktualniania aplikacji.

  • Zresetowanie ustawień aplikacji do ich wartości domyślnych dla aktualnie używanej wersji.

Klasa LocalFileSettingsProvider implementuje interfejs IApplicationSettingsProvider. Ten sam zestaw metod zawartych IApplicationSettingsProvider w klasie znajduje się również w ApplicationSettingsBase klasie, umożliwiając utworzenie wstępnie zdefiniowanego kanału komunikacyjnego między otoką ustawień aplikacji a jego dostawcą ustawień.

Uwaga

Ten interfejs jest opcjonalny. Jeśli dostawca nie zaimplementuje tego interfejsu, infrastruktura ustawień zakończy się niepowodzeniem bez powiadomienia, jeśli spróbuje uzyskać dostęp do dowolnych metod zdefiniowanych przez ten interfejs.

Metody

GetPreviousVersion(SettingsContext, SettingsProperty)

Zwraca wartość określonej właściwości ustawień dla poprzedniej wersji tej samej aplikacji.

Reset(SettingsContext)

Resetuje ustawienia aplikacji skojarzone z określoną aplikacją do ich wartości domyślnych.

Upgrade(SettingsContext, SettingsPropertyCollection)

Wskazuje dostawcę, że aplikacja została uaktualniona. Oferuje to dostawcy możliwość odpowiedniego uaktualnienia przechowywanych ustawień.

Dotyczy

Zobacz też