IApplicationSettingsProvider 인터페이스

정의

클라이언트 기반 애플리케이션 설정 공급자의 확장 기능을 정의합니다.Defines extended capabilities for client-based application settings providers.

public interface class IApplicationSettingsProvider
public interface IApplicationSettingsProvider
type IApplicationSettingsProvider = interface
Public Interface IApplicationSettingsProvider
파생

설명

애플리케이션 설정 아키텍처에서 파생 된 클래스는 사용자 지정 설정 공급자를 만들어 애플리케이션 설정에 대 한 사용자 지정 스토리지 메커니즘을 제공 하면 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. 이러한 클래스에는 속성을 저장 하 고 검색 하기 위한 기본 기능이 포함 되어 있습니다.Such a class contains the basic functionality for storing and retrieving properties. 그러나 IApplicationSettingsProvider 사용자 지정 설정 공급자에서 인터페이스를 구현 하 여 표준화 된 기능을 더 추가할 수 있습니다.However, you can add additional standardized functionality by implementing the IApplicationSettingsProvider interface in the custom settings provider. 이 인터페이스는 주로 더 지능적으로 핸들 애플리케이션 버전을 변경 하는 설정 공급자를 사용 하도록 설정 하는 세 가지 메서드를 포함 합니다.This interface contains three methods that primarily enable the settings provider to more intelligently handle application version changes. 일반적으로 설정 공급자에는 다음과 같은 경우 예측을 개별적으로 애플리케이션의 서로 다른 버전에 대 한 애플리케이션 설정을 저장 됩니다.Typically, the settings provider will store application settings for different versions of an application separately to anticipate the following circumstances:

  • 애플리케이션의 서로 다른 버전의 side-by-side-실행 합니다.Side-by-side execution of different versions of an application.

  • 애플리케이션 설정을 유지 하는 애플리케이션을 업그레이드 하는 경우입니다.Retaining application settings when upgrading an application.

  • 애플리케이션 설정을 현재 사용 되는 버전에 대 한 기본값으로 다시 설정 합니다.Resetting the application settings to their default values for the currently used version.

LocalFileSettingsProvider 클래스가 IApplicationSettingsProvider 인터페이스를 구현합니다.The LocalFileSettingsProvider class implements the IApplicationSettingsProvider interface. 동일한 집합에 포함 된 메서드의 IApplicationSettingsProvider 발견 되는 ApplicationSettingsBase 클래스에는 애플리케이션 설정 래퍼 및 해당 설정 공급자 간에 미리 정의 된 통신 채널을 구축을 사용 하도록 설정 합니다.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.

참고

이 인터페이스는 선택 사항입니다.This interface is optional. 공급자가이 인터페이스를 구현 하지 않는 경우 설정 인프라는이 인터페이스에서 정의한 메서드에 액세스 하려고 할 때 알림 없이 실패 합니다.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.

메서드

GetPreviousVersion(SettingsContext, SettingsProperty)

이전 버전의 동일한 애플리케이션에 대한 지정된 설정 속성의 값을 반환합니다.Returns the value of the specified settings property for the previous version of the same application.

Reset(SettingsContext)

지정된 애플리케이션과 연결된 애플리케이션 설정을 기본값으로 다시 설정합니다.Resets the application settings associated with the specified application to their default values.

Upgrade(SettingsContext, SettingsPropertyCollection)

애플리케이션이 업그레이드되었음을 공급자에게 알립니다.Indicates to the provider that the application has been upgraded. 이를 통해 공급자는 저장된 설정을 적절하게 업그레이드할 수 있습니다.This offers the provider an opportunity to upgrade its stored settings as appropriate.

적용 대상

추가 정보