System.Configuration.LocalFileSettingsProvider.Upgrade 方法

上一篇：System.Configuration.LocalFileSettingsProvider.SetPropertyValues 方法下一篇：system.configuration.longvalidator 类

方法描述

尝试从相同应用程序的早期版本迁移以前的用户范围设置。

语法定义(C# System.Configuration.LocalFileSettingsProvider.Upgrade 方法的用法)

public void Upgrade(
	SettingsContext context,
	SettingsPropertyCollection properties
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
context	System-Configuration-SettingsContext	描述当前应用程序用法的 SettingsContext。
properties	System-Configuration-SettingsPropertyCollection	一个包含设置属性组（将要检索该组中的值）的 SettingsPropertyCollection。
返回值	void

提示和注释

LocalFileSettingsProvider 单独进行本地和漫游设置的迁移操作。

对于每个应用 NoSettingsVersionUpgradeAttribute 的应用程序设置或派生自 ApplicationSettingsBase 的整个设置包装类，将取消 Upgrade 方法。

如何调用此方法取决于正在被升级的应用程序的类型：

每个版本的 ClickOnce 应用程序均存储在其独立的安装目录中。安装了新版本的 ClickOnce 应用程序之后，在第一次运行此新版本时，内部逻辑将自动调用 Upgrade 将所有公共应用程序设置迁移到新版本。有关更多信息，请参见 ClickOnce 和应用程序设置。

由于没有通用的方法自动确定何时应用程序第一次运行，因此标准 Windows 窗体和控制台应用程序必须手动调用 Upgrade。通常可以使用保存的属性（通常命名为类似 IsFirstRun 的名称）从安装程序或使用应用程序本身两种方法执行此操作。

注意，要迁移应用程序设置的较新版本必须还能够加载和读取较旧版本的应用程序设置。因此，它必须包含同时兼容应用程序新版本和早期版本的包装类。