IApplicationSettingsProvider Interfejs

Definicja

Definiuje rozszerzone możliwości dla dostawców ustawień aplikacji opartych na kliencie.Defines extended capabilities for client-based application settings providers.

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

Uwagi

Architektura ustawień aplikacji umożliwia zapewnienie niestandardowego mechanizmu magazynowania dla ustawień aplikacji przez utworzenie niestandardowego dostawcy ustawień, który jest klasą pochodną SettingsProvider .The application settings architecture enables you to provide a custom storage mechanism for application settings by creating a custom settings provider, which is a class derived from SettingsProvider. Taka Klasa zawiera podstawowe funkcje przechowywania i pobierania właściwości.Such a class contains the basic functionality for storing and retrieving properties. Można jednak dodać dodatkowe funkcje standardowe, implementując IApplicationSettingsProvider interfejs w dostawcy ustawień niestandardowych.However, you can add additional standardized functionality by implementing the IApplicationSettingsProvider interface in the custom settings provider. Ten interfejs zawiera trzy metody, które przede wszystkim umożliwiają dostawcy ustawień bardziej inteligentnie obsługiwać zmiany wersji aplikacji.This interface contains three methods that primarily enable the settings provider to more intelligently handle application version changes. Zazwyczaj Dostawca ustawień będzie przechowywać ustawienia aplikacji dla różnych wersji aplikacji oddzielnie, aby przewidzieć następujące sytuacje:Typically, the settings provider will store application settings for different versions of an application separately to anticipate the following circumstances:

  • Wykonywanie równoczesne różnych wersji aplikacji.Side-by-side execution of different versions of an application.

  • Zachowywanie ustawień aplikacji podczas uaktualniania aplikacji.Retaining application settings when upgrading an application.

  • Resetowanie ustawień aplikacji do wartości domyślnych dla aktualnie używanej wersji.Resetting the application settings to their default values for the currently used version.

Klasa LocalFileSettingsProvider implementuje interfejs IApplicationSettingsProvider.The LocalFileSettingsProvider class implements the IApplicationSettingsProvider interface. Ten sam zestaw metod zawartych IApplicationSettingsProvider w programie znajduje się również w ApplicationSettingsBase klasie, umożliwiając zakładanie wstępnie zdefiniowanego kanału komunikacyjnego między otoką ustawień aplikacji a jej dostawcą ustawień.The same set of methods contained by IApplicationSettingsProvider is also found in the ApplicationSettingsBase class, enabling the establishment of a predefined communication channel between an application settings wrapper and its settings provider.

Uwaga

Ten interfejs jest opcjonalny.This interface is optional. Jeśli dostawca nie implementuje tego interfejsu, infrastruktura ustawień zakończy się niepowodzeniem bez powiadomienia, jeśli próbuje uzyskać dostęp do dowolnych metod zdefiniowanych przez ten interfejs.If a provider does not implement this interface, the settings infrastructure will fail without notification if it attempts to access any of the methods defined by this interface.

Metody

GetPreviousVersion(SettingsContext, SettingsProperty)

Zwraca wartość określonej właściwości ustawienia dla poprzedniej wersji tej samej aplikacji.Returns the value of the specified settings property for the previous version of the same application.

Reset(SettingsContext)

Resetuje ustawienia aplikacji skojarzone z określoną aplikacją do wartości domyślnych.Resets the application settings associated with the specified application to their default values.

Upgrade(SettingsContext, SettingsPropertyCollection)

Wskazuje dostawcy, że aplikacja została uaktualniona.Indicates to the provider that the application has been upgraded. Dzięki temu dostawca może uaktualnić przechowywane ustawienia zgodnie z potrzebami.This offers the provider an opportunity to upgrade its stored settings as appropriate.

Dotyczy

Zobacz też