System.Configuration.LocalFileSettingsProvider.Upgrade 方法
方法描述
尝试从相同应用程序的早期版本迁移以前的用户范围设置。
语法定义(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 的名称)从安装程序或使用应用程序本身两种方法执行此操作。
注意,要迁移应用程序设置的较新版本必须还能够加载和读取较旧版本的应用程序设置。 因此,它必须包含同时兼容应用程序新版本和早期版本的包装类。
System.Configuration.LocalFileSettingsProvider.Upgrade 方法例子
异常
异常 | 异常描述 |
---|---|
ConfigurationErrorsException |
|
版本信息
.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。