IApplicationSettingsProvider.Upgrade 方法

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

Source:

IApplicationSettingsProvider.cs

向提供程序指出应用程序已升级。 这给提供程序提供了一个机会，使其可以相应地升级其存储的设置。

public:
 void Upgrade(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyCollection ^ properties);

public void Upgrade (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyCollection properties);

abstract member Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit

Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

参数

context

SettingsContext

描述当前应用程序用法的 SettingsContext。

properties

SettingsPropertyCollection

一个包含设置属性组（将要检索该组中的值）的 SettingsPropertyCollection。

注解

.NET Framework支持并行安装和执行同一应用程序的不同版本。 应用程序设置提供程序单独存储每个版本的应用程序设置，以确保隔离。 但是，可能需要将设置从以前版本的应用程序迁移到当前版本。 若要提供此迁移功能，请使用 Upgrade 方法，该方法在派生自 SettingsProvider的类中实现。

可以将 Upgrade 方法与 GetPreviousVersion 方法结合使用，以在安装新版本的应用程序期间或之后迁移应用程序设置。

对于应用的每个应用程序设置 NoSettingsVersionUpgradeAttribute ，或从 派生 ApplicationSettingsBase的整个设置包装类，应禁止使用此方法。

另请参阅

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Upgrade()
• NoSettingsVersionUpgradeAttribute
• 并行执行