IApplicationSettingsProvider Interfejs

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

IApplicationSettingsProvider.cs

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

System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

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ń.

Zobacz też

• SettingsProvider
• ApplicationSettingsBase
• Architektura ustawień aplikacji