IApplicationSettingsProvider 接口

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

Source:

IApplicationSettingsProvider.cs

为基于客户端的应用程序的设置提供程序定义扩展功能。

public interface class IApplicationSettingsProvider

public interface IApplicationSettingsProvider

type IApplicationSettingsProvider = interface

Public Interface IApplicationSettingsProvider

派生

System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

注解

应用程序设置体系结构使你能够通过创建自定义设置提供程序（派生自 SettingsProvider的类）为应用程序设置提供自定义存储机制。 此类包含用于存储和检索属性的基本功能。 但是，可以通过在自定义设置提供程序中实现 IApplicationSettingsProvider 接口来添加其他标准化功能。 此接口包含三种方法，这些方法主要使设置提供程序能够更智能地处理应用程序版本更改。 通常，设置提供程序将单独存储不同版本的应用程序设置，以预测以下情况：

• 并行执行不同版本的应用程序。

• 升级应用程序时保留应用程序设置。

• 将应用程序设置重置为当前使用的版本的默认值。

LocalFileSettingsProvider 类实现 IApplicationSettingsProvider 接口。 类中ApplicationSettingsBase也提供了包含IApplicationSettingsProvider的同一组方法，从而在应用程序设置包装器及其设置提供程序之间建立预定义的信道。

注意

此接口是可选的。 如果提供程序未实现此接口，则如果设置基础结构尝试访问此接口定义的任何方法，则设置基础结构将失败，且不会发出通知。

方法

GetPreviousVersion(SettingsContext, SettingsProperty)	返回同一应用程序早期版本的指定设置属性的值。
Reset(SettingsContext)	将与指定应用程序关联的应用程序设置重置为其默认值。
Upgrade(SettingsContext, SettingsPropertyCollection)	向提供程序指出应用程序已升级。 这给提供程序提供了一个机会，使其可以相应地升级其存储的设置。

另请参阅

• SettingsProvider
• ApplicationSettingsBase
• 应用程序设置体系结构