バージョン アップグレード ユーティリティの使用

コンテンツをアップグレードする前に、以下の点に留意してください:

以下は、アップグレード手順の概要です。

ユーティリティの最初の画面が開きます。選択してください。

アップグレードしたいコンテンツのタイプを選択し、ナビゲートして読み込みます。

図 1: バージョン ユーティリティの選択手順

コンテンツが読み込まれたら、バージョン ユーティリティは解析を開始します。解析中は次のような画面が表示します。解析してください。

図 2: バージョン ユーティリティの解析手順

解析が完了すると、ユーティリティはタスク リストを作成します。これには処理される必要があるファイルの概要を示します。次にステップに進みます。

各リスト項目を展開してタスクを確認します。

図 3: バージョン ユーティリティの確認手順

アップグレードをカスタマイズするには、[アップグレード オプション] リンクをクリックします。これによって、[アップグレード オプション] ダイアログが開きます。

図 4: [アップグレード オプション] ダイアログ

注:

解析が完了したら、[アップグレード] ボタンをクリックします。アップグレード処理が開始されます。

図 5: バージョン ユーティリティのアップグレード手順

このユーティリティは、ソリューションをアップグレードするために必要なファイルだけを変更します。ソリューション内の以下のファイルだけが変更されます:

処理が完了したら、ユーティリティの最後のステップに進みます。

変換の成功

すべての識別されたアップグレード タスクが成功すると、バージョン ユーティリティは成功したことを通知し、また変更のログ ファイルへのリンクを提供します。

図 6: バージョン ユーティリティの完了手順 - アップグレードの成功

バックアップを許可するオプションが有効になっていれば、すべての変更されたファイルはユーティリティの Backup フォルダーにバックアップされています。

注:

[その他のソリューション、プロジェクト、またはウエブサイトをアップグレードする] オプションでは、同じ変換オプションを使用して別のソリューションを変換するための簡単な方法が提供されます。ただし、アップグレード処理に異なる設定が必要な場合には、アプリケーションを終了して新たに実行する必要があります。

この時点で、アプリケーションのソース コードに変更が行われた時に通常講じるのと同じ措置を講じる必要があります。つまり、Microsoft® Visual Studio でアプリケーションを開き、ソースコードを確認して、コンパイルし、そしてテストすることです。

変換の失敗

ユーティリティが処理できない状態に遭遇した場合、エラーが発生した時点でアップグレード処理を停止し、状況を通知します。

図 7: バージョン ユーティリティの完了手順 - アップグレードの失敗

この時点で、ログ ファイルを使用してどのようなエラーが発生したかを識別して、エラーを手動で解決することができます。ログ ファイルに報告されているエラーを解決したら、アップグレード処理を再試行すると、ユーティリティは完了していないアップグレード タスクを処理することができます。もちろん、この方法の代わりに、アプリケーションを手動でアップグレードすることができます。