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

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

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

こちらもご覧ください

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Upgrade()
• NoSettingsVersionUpgradeAttribute
• side-by-side 実行