IApplicationSettingsProvider.Upgrade メソッド

.NET Framework クラス ライブラリ リファレンス

IApplicationSettingsProvider.Upgrade メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Configuration
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Sub Upgrade ( _
    context As SettingsContext, _
    properties As SettingsPropertyCollection _
)

Visual Basic (使用法)

Dim instance As IApplicationSettingsProvider
Dim context As SettingsContext
Dim properties As SettingsPropertyCollection

instance.Upgrade(context, properties)

C#

void Upgrade (
    SettingsContext context,
    SettingsPropertyCollection properties
)

C++

void Upgrade (
    SettingsContext^ context, 
    SettingsPropertyCollection^ properties
)

J#

void Upgrade (
    SettingsContext context, 
    SettingsPropertyCollection properties
)

JScript

function Upgrade (
    context : SettingsContext, 
    properties : SettingsPropertyCollection
)

パラメータ

context

現在のアプリケーションの使い方を記述している SettingsContext。

properties

値の取得対象となる設定プロパティ グループを格納している SettingsPropertyCollection。

解説

.NET Framework を使用すると、同じアプリケーションの異なるバージョンの side-by-side インストールおよび side-by-side 実行を行うことができます。アプリケーション設定プロバイダは、アプリケーションの各バージョンのアプリケーション設定を個別に格納して確実に分離します。ただし、前のバージョンのアプリケーションから現在のバージョンに設定を移行することもできます。この移行機能を提供するには、SettingsProvider から派生したクラスに実装されている Upgrade メソッドを使用します。

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IApplicationSettingsProvider インターフェイス
IApplicationSettingsProvider メンバ
System.Configuration 名前空間
GetPreviousVersion
ApplicationSettingsBase.Upgrade
NoSettingsVersionUpgradeAttribute
その他の技術情報
side-by-side 実行