増分的なASP.NETからASP.NET Coreへの移行を開始する方法

大規模な移行では、元の .NET Framework アプリにプロキシする ASP.NET Core アプリを設定することをお勧めします。 新しいプロキシが有効なアプリを次の図に示します。

移行プロセスでこの方法がどのように役立つのかを理解するには、「ASP.NET から ASP.NET Core への増分移行」を参照してください。 この記事の残りの部分では、増分移行を続行する手順について説明します。

ASP.NET Core プロジェクトをセットアップする

増分移行に必要なプロジェクトの設定については、 ASP.NET MVC、Web API、Web フォームから ASP.NET Core へのアップグレードについて説明 します。

サポート ライブラリのアップグレード

ソリューションに使用する必要があるサポート ライブラリがある場合は、可能であれば.NET Standard 2.0 にアップグレードする必要があります。 アップグレード アシスタント は、このための優れたツールです。 ライブラリで .NET Standard をターゲットにできない場合は、元のプロジェクトの .NET Framework ターゲットと共に、または元のプロジェクトと共に新しいプロジェクトで.NET 6 以降をターゲットにすることができます。

これらのライブラリで アダプターを 使用して、クラス ライブラリでの System.Web.HttpContext の使用をサポートできます。 ライブラリで System.Web.HttpContext の使用を有効にするには、

1. プロジェクト ファイル内の System.Web への参照を削除する
2. Microsoft.AspNetCore.SystemWebAdapters パッケージを追加する
3. マルチターゲットを有効にして .NET 6 ターゲット以降を追加するか、プロジェクトを .NET Standard 2.0 に変換します。
4. ターゲット フレームワークで .NET Core がサポートされていることを確認します。 .NET Standard 2.0 で十分でない場合は、マルチターゲットを使用できます

この手順では、ソリューションの構造に応じて、多数のプロジェクトの変更が必要になる場合があります。 アップグレード アシスタントは、プロセスの複数の手順を変更して自動化する必要があるものを特定するのに役立ちます。

セッション サポートを有効にする

セッションは、ASP.NET Core の機能と名前を共有する ASP.NET の一般的な機能であり、API は大きく異なります。 セッションのサポートに関するドキュメントを参照してください。

共有認証のサポートを有効にする

System.Web アダプターのリモート認証機能を使用して、元の ASP.NET アプリと新しい ASP.NET Core アプリの間で認証を共有できます。 この機能により、ASP.NET Core アプリは認証を ASP.NET アプリに延期できます。 詳細については、 リモート アプリ接続 と リモート認証 に関するドキュメントを参照してください。

一般的な使用ガイダンス

ASP.NET と ASP.NET Core には、アダプターが更新に役立つさまざまな違いがあります。 ただし、一部のコストが発生するため、オプトインが必要な機能がいくつかあります。 適応できない動作もあります。 これらの一覧については、 使用ガイダンス を参照してください。