ApplicationSettingsBase.Upgrade 方法

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

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)