.NET Upgrade Assistant を使用してプロジェクトをアップグレードする

この記事では、.NET Upgrade Assistant を使用してプロジェクトをアップグレードするための基本的な手順を説明します。 これには、アップグレードの開始と結果の確認が含まれます。 プロジェクトの複雑さに基づいて、コードを手動で更新する必要がある場合があります。

Important

.NET アップグレード アシスタントは正式に非推奨です。 代わりに GitHub Copilot アプリのモダン化チャット エージェント を使用します。これは、Visual Studio 2026 および Visual Studio 2022 17.14.16 以降に含まれています。 このエージェントは、プロジェクトと依存関係を分析し、ターゲットの推奨事項と自動コード修正を使用して段階的な移行計画を作成し、各変更をコミットして検証またはロールバックできるようにします。 プロジェクト ファイルの更新、非推奨の API の置き換え、ビルドの問題の解決など、一般的な移植タスクが自動化されるため、手動作業を減らすことで、より迅速に最新化できます。

一部のプロジェクトの種類には、アップグレードに関する特定のガイダンスがあります。 詳細については、「 サポートされているプロジェクトの種類」を参照してください。

前提条件

• Visual Studio については、「.NET アップグレード アシスタント インストール - Visual Studio 拡張機能の」を参照してください。
• .NET グローバル ツールについては、「.NET アップグレード アシスタントのインストール - .NET グローバル ツール」を参照してください。

Visual Studio でプロジェクトをアップグレードする

Visual Studio でプロジェクトをアップグレードするには、次の手順に従います。

1. コードをバックアップします。

2. Visual Studio を開きます。

3. プロジェクトまたはソリューションを開きます。

4. ソリューション エクスプローラー ウィンドウで、project>Upgrade を右クリックします。

   

5. アップグレード タブで、適切なアップグレード オプションを選択します。

   プロジェクトの種類とターゲット フレームワークのバージョンに基づいて、さまざまなオプションが表示されます。 次の図は、.NET Framework プロジェクトのWindows フォームをアップグレードするときの 2 つのオプションを示しています。 .NET プロジェクトをアップグレードするときに、次のオプションは表示されません。

   

   この例では、 プロジェクトを新しい .NET バージョンにアップグレードを選択します。

6. アップグレードの実行方法を選択します。 プロジェクトのアップグレードをインプレースで選択し次へを選択。

   一部のプロジェクトでは、1 つのオプションのみが表示される場合があります。 これらのオプションの詳細については、「 アップグレードを実行する方法を参照してください。

   

7. ターゲット フレームワークを選択します (例: .NET 8.0。 次に、 [次へ] を選択します。

   

8. アップグレードするコンポーネントを選択し、 アップグレードの選択を選択します。

   

9. アップグレードが完了すると、処理された項目の一覧が表示されます。

   

アップグレードによって処理された各成果物が、その状態と共に一覧表示されます。 詳細については、「 アップグレードの結果を参照してください。

CLI からプロジェクトをアップグレードする

ターミナルを使用してプロジェクトをアップグレードするには、次の手順に従います。 .NET グローバル ツールは、アップグレード オプションについて説明する対話型ツールです。 上方向キーおよび下方向キーキーを使用して強調表示されたオプションを変更し、Enter を使用してオプションを選択します。 各画面には、アップグレードの構成方法に関するオプションが表示されます。

1. コードをバックアップします。

2. ターミナルを開き、アップグレードするソリューションまたはプロジェクトが含まれているフォルダーに移動します。

3. ツールを起動するには、 upgrade-assistant upgrade コマンドを実行します。

   アップグレードする内容について質問されます。 検出される内容によっては、一部のオプションが自動的に適用されるか、完全に欠落している場合があります。

   

4. 複数のプロジェクトが見つかった場合は、いずれかのプロジェクトを選択し、 Enter キーを押します。

   依存関係の順序でプロジェクトをアップグレードします。 たとえば、前の画像には、 MatchingGame と MatchingGame.Logicの 2 つのプロジェクトが示されています。 MatchingGame は MatchingGame.Logicに依存するため、最初に MatchingGame.Logic アップグレードする必要があります。

5. アップグレードの種類を変更するオプションがある場合はいずれかを選択し、Enter キーを押します。 使用可能なオプションが 1 つだけの場合は、自動的に選択されます。

   これらのオプションの詳細については、「 アップグレードを実行する方法を参照してください。

   ヒント

   コードをバックアップした場合は、 インプレース プロジェクトのアップグレードを選択しても安全です。

6. .NET 8.0 などのターゲット フレームワークを選択、Enter キーを押します。

7. 最後のプロンプトが確認され、選択したすべてのオプションが表示されます。 Enter キーを押してアップグレードを開始します。

   

8. アップグレードが完了すると、概要が表示されます。

   

関連するコンテンツ

• .NET アップグレード アシスタントとは
• .NET アップグレード アシスタントを使用したコード分析とは
• .NET アップグレード アシスタントを使用してプロジェクトを分析する