LocalFileSettingsProvider.Upgrade 方法

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

LocalFileSettingsProvider.cs

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

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，包含要擷取其值的設定屬性群組。

實作

Upgrade(SettingsContext, SettingsPropertyCollection)

例外狀況

ConfigurationErrorsException

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

-或-

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

備註

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

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

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

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

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

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

另請參閱

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Reset(SettingsContext)
• IApplicationSettingsProvider
• NoSettingsVersionUpgradeAttribute