ApplicationSettingsBase.Upgrade メソッド

public:
 virtual void Upgrade();

public virtual void Upgrade();

abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit

Public Overridable Sub Upgrade ()

例外

注釈

Upgradeメソッドは、アプリケーションの新しいバージョンへのスムーズな移行を保証するために、次の 2 つのアクションを実行します。

• IApplicationSettingsProvider.Upgrade インターフェイスが実装されていると仮定して、IApplicationSettingsProvider メソッドの呼び出しを通じて、アップグレードされたアプリケーションの存在を対応するすべての設定プロバイダーに通知します。 設定ラッパー クラスが NoSettingsVersionUpgradeAttribute でマークされている場合、このアクションは実行されません。

• すべてのアプリケーション設定の値が再読み込みされます。

Upgradeの既定の動作をオーバーライドして、カスタムアップグレードまたはマージ動作を実装できます。 GetPreviousVersionメソッドを使用して、アプリケーションの以前のバージョンの設定の個々の値を取得します。 カスタム アップグレード動作の例を次に示します。

• 以前のユーザー指定の値または以前の既定値の 1 つ以上をオーバーライドする新しいポリシーの既定値を使用します。

• 新しい範囲、別の設定プロパティ グループなどと互換性のある古い値の特別な変換。

こちらもご覧ください

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)