System.Configuration.ApplicationSettingsBase.Upgrade 方法

方法描述

更新应用程序设置,以反映最近安装的应用程序。

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

public virtual void Upgrade()

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
返回值 void

提示和注释

Upgrade 方法将执行两项操作,以确保顺利转换到新版本的应用程序:

此方法通过调用所有对应设置提供程序的 IApplicationSettingsProvider.Upgrade 方法来通知它们存在已升级的应用程序,前提条件是这些提供程序已实现 IApplicationSettingsProvider 接口。 如果设置包装类使用 NoSettingsVersionUpgradeAttribute 进行标记,则不会执行此操作。

该方法将重新加载所有应用程序设置的值。

若要实现自定义升级或合并行为,可以重写 Upgrade 的默认行为。 使用 GetPreviousVersion 方法可以检索与早期版本的应用程序的设置相对应的各个值。 有关自定义升级行为的示例包括:

使用新的策略默认设置重写一个或多个用户以前指定的值或以前的默认值。

对旧值进行特别转换,使其与较新的范围、不同的设置属性组等兼容。

System.Configuration.ApplicationSettingsBase.Upgrade 方法例子


异常

异常 异常描述
ConfigurationErrorsException 未能分析配置文件。

命名空间

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