ApplicationSettingsBase.Upgrade 方法

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

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

public:
 virtual void Upgrade();

public virtual void Upgrade ();

abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit

Public Overridable Sub Upgrade ()

例外

ConfigurationErrorsException

未能分析配置文件。

注解

方法 Upgrade 执行两个操作，以确保顺利过渡到应用程序的新版本：

• 它通过调用其 IApplicationSettingsProvider.Upgrade 方法（假设它们已实现 IApplicationSettingsProvider 接口）通知所有相应的设置提供程序已升级的应用程序是否存在。 如果设置包装类标记为 NoSettingsVersionUpgradeAttribute，则不会执行此操作。

• 它将重新加载所有应用程序设置的值。

可以替代 的默认行为 Upgrade ，以实现自定义升级或合并行为。 GetPreviousVersion使用 方法检索以前版本的应用程序的设置的各个值。 自定义升级行为的示例包括：

• 使用覆盖一个或多个以前的用户指定值或以前的默认值的新策略默认值。

• 旧值的特殊转换，以便与较新的范围、不同的设置属性组等兼容。

另请参阅

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)