ApplicationSettingsBase.Upgrade メソッド

定義

名前空間:

System.Configuration

アセンブリ:

System.Configuration.ConfigurationManager.dll

パッケージ:

System.Configuration.ConfigurationManager v8.0.0

ソース:

ApplicationSettingsBase.cs

アプリケーション設定を更新して、アプリケーションの最新のインストールを反映します。

public:
 virtual void Upgrade();

public virtual void Upgrade ();

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

Public Overridable Sub Upgrade ()

例外

ConfigurationErrorsException

構成ファイルを解析できませんでした。

注釈

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

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

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

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

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

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

こちらもご覧ください

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