ApplicationSettingsBase.Upgrade 方法

public:
 virtual void Upgrade();

public virtual void Upgrade();

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

Public Overridable Sub Upgrade ()

例外

注解

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

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

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

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

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

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

另请参阅

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