共用方式為


LocalFileSettingsProvider.Upgrade 方法

定義

嘗試從舊版的同一應用程式中移轉先前的使用者範圍中的設定。

public:
 virtual void Upgrade(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyCollection ^ properties);
public void Upgrade (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyCollection properties);
abstract member Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit
override this.Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit
Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

參數

context
SettingsContext

SettingsContext,描述目前應用程式的使用方式。

properties
SettingsPropertyCollection

SettingsPropertyCollection,包含要擷取其值的設定屬性群組。

實作

例外狀況

遇到了使用者範圍的設定,但是目前的組態僅支援應用程式範圍的設定。

-或-

無法存取組態檔的前一版本。

備註

LocalFileSettingsProvider 在個別作業中移轉本機和漫遊設定。

針對 Upgrade 已套用至它的每個應用程式設定 NoSettingsVersionUpgradeAttribute ,或衍生自 ApplicationSettingsBase的整個設定包裝函式類別,都會隱藏 方法。

此方法的呼叫方式取決於正在升級的應用程式類型:

  • ClickOnce 應用程式的每個版本都會儲存在其自己的隔離安裝目錄中。 安裝新版本的 ClickOnce 應用程式之後,而且第一次執行新版本時,內部邏輯會自動呼叫 Upgrade 以將所有常見的應用程式設定移轉至新版本。 如需詳細資訊,請參閱 ClickOnce 和應用程式設定

  • 標準 Windows Forms 和主控台應用程式必須手動呼叫 Upgrade,因為沒有一般、自動的方式來判斷這類應用程式第一次執行時。 執行此作業的兩個常見方式包括從安裝程式或使用應用程式本身,使用持續性屬性,通常命名如下 IsFirstRun

請注意,若要讓較新版本移轉應用程式設定,它必須能夠載入及讀取舊版的應用程式設定。 因此,它必須包含與新版和舊版應用程式相容的包裝函式類別。

適用於

另請參閱