IApplicationSettingsProvider.Upgrade 方法

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

IApplicationSettingsProvider.cs

指示提供者應用程式已升級。 這讓提供者可以適當升級其儲存的設定。

public:
 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

Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

參數

context

SettingsContext

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

properties

SettingsPropertyCollection

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

備註

.NET Framework 可同時安裝和執行相同應用程式的不同版本。 應用程式設定提供者會個別儲存應用程式每個版本的應用程式設定，以確保隔離。 不過，您可能想要將舊版應用程式的設定移轉至目前的設定。 若要提供此移轉功能，請使用 Upgrade 方法，在衍生自 SettingsProvider的類別中實作。

您可以使用 Upgrade 方法搭配 GetPreviousVersion 方法，在安裝新版本的應用程式期間或之後移轉應用程式設定。

對於已套用 至的每個應用程式設定 NoSettingsVersionUpgradeAttribute ，或衍生自 ApplicationSettingsBase的整個設定包裝函式類別，應該隱藏這個方法。

另請參閱

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Upgrade()
• NoSettingsVersionUpgradeAttribute
• 並存執行