ApplicationSettingsBase.Upgrade メソッド

  • リファレンス

定義

名前空間:
System.Configuration
アセンブリ:
System.Configuration.ConfigurationManager.dll
アセンブリ:
System.dll
パッケージ:
System.Configuration.ConfigurationManager v6.0.0
パッケージ:
System.Configuration.ConfigurationManager v7.0.0
パッケージ:
System.Configuration.ConfigurationManager v8.0.0
パッケージ:
System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5
ソース:
ApplicationSettingsBase.cs
ソース:
ApplicationSettingsBase.cs
ソース:
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 つ以上をオーバーライドする新しいポリシーの既定値を使用します。

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

適用対象

こちらもご覧ください