System.Configuration.IApplicationSettingsProvider.Upgrade 方法

上一篇：_AppDomain 方法 下一篇：ICloneable 方法

方法描述

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

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

[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
void Upgrade(
	SettingsContext context,
	SettingsPropertyCollection properties
)

参数/返回值

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

提示和注释

.NET Framework 允许并行安装和执行同一应用程序的不同版本。 为了确保彼此隔离，应用程序设置提供程序会为每个应用程序版本单独存储应用程序设置。 不过，有时可能要把早期版本的应用程序中的设置迁移到当前的版本中来。 若要提供此迁移功能，请使用 Upgrade 方法，该方法已在从 SettingsProvider 派生出的一个类中实现。

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

对于应用了 NoSettingsVersionUpgradeAttribute 的每个应用程序设置、或整个设置包装类（从 ApplicationSettingsBase 派生而来），此方法应被取消。

System.Configuration.IApplicationSettingsProvider.Upgrade 方法例子

异常

异常 异常描述

命名空间

namespace: System.Configuration

程序集: System（在 System.dll 中）

版本信息

.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 系统要求。

相关资源

IApplicationSettingsProvider 接口
System.Configuration 命名空间
GetPreviousVersion
ApplicationSettingsBase.Upgrade
NoSettingsVersionUpgradeAttribute
并行执行
MSDN
上一篇：_AppDomain 方法 下一篇：ICloneable 方法