次の方法で共有


IApplicationSettingsProvider.Upgrade メソッド

定義

アプリケーションがアップグレードされたことをプロバイダーに示します。 これにより、プロバイダーは格納している値を必要に応じてアップグレードできます。

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を使用すると、同じアプリケーションのさまざまなバージョンのサイド バイ サイド インストールと実行が可能になります。 アプリケーション設定プロバイダーは、分離を確保するために、アプリケーションの各バージョンのアプリケーション設定を個別に格納します。 ただし、以前のバージョンのアプリケーションから現在のアプリケーションに設定を移行したい場合があります。 この移行機能を提供するには、 からSettingsProvider派生したクラスに実装されている メソッドを使用Upgradeします。

メソッドを Upgrade メソッドと GetPreviousVersion 組み合わせて使用して、新しいバージョンのアプリケーションのインストール中またはインストール後にアプリケーション設定を移行できます。

このメソッドは、 が適用されているすべてのアプリケーション設定 NoSettingsVersionUpgradeAttribute 、または から ApplicationSettingsBase派生した設定ラッパー クラス全体に対して抑制する必要があります。

適用対象

こちらもご覧ください