EF Core への EF6 コードベース モデルの移植

すべての注意事項を読み、移植の準備ができたら、次のガイドラインを参考にして作業を開始してください。

EF Core の NuGet パッケージをインストールする

EF Core を使用するには、使用するデータベース プロバイダーに対して NuGet パッケージをインストールします。 たとえば、SQL Server を対象とする場合は、Microsoft.EntityFrameworkCore.SqlServer をインストールします。 詳細については、「データベース プロバイダー」を参照してください。

移行の使用を計画している場合は、Microsoft.EntityFrameworkCore.Tools パッケージもインストールする必要があります。

EF6 NuGet パッケージ (EntityFramework) はインストールされたままにしておくことをお勧めします。これは EF Core と EF6 を同じアプリケーションで並列で使用できるようにするためです。 ただし、アプリケーションのどの領域でも EF6 を使用するつもりがない場合は、パッケージをアンインストールすることで、注意が必要なコード上にコンパイル エラーを表示することができます。

名前空間をスワップする

EF6 で使用する API のほとんどは、System.Data.Entity 名前空間 (および関連するサブ名前空間) にあります。 最初のコード変更では、Microsoft.EntityFrameworkCore 名前空間にスワップします。 通常は、派生コンテキスト コード ファイルから開始し、そこで作業を行い、コンパイル エラーが発生したら対処します。

コンテキストの構成 (接続など)

「データベース接続の構成」で説明しているように、EF Core には、接続先のデータベースを検出する特別な方法はあまりありません。 派生コンテキストで OnConfiguring メソッドをオーバーライドし、API 固有のデータベース プロバイダーを使用してデータベースへの接続を設定する必要があります。

ほとんどの EF6 アプリケーションでは、接続文字列がアプリケーションの App/Web.config ファイルに格納されます。 EF Core では、ConfigurationManager API を使用してこの接続文字列を読み取ります。 この API を使用できるようにするには、System.Configuration フレームワーク アセンブリに参照を追加しなければならない場合があります。

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
      optionsBuilder.UseSqlServer(ConfigurationManager.ConnectionStrings["BloggingDatabase"].ConnectionString);
    }
}

コードを更新する

この時点では、コンパイル エラーに対処し、コードを見直して、動作変更の影響があるかどうかを確認します。

既存の移行

既存の EF6 移行を EF Core に移植する方法は実際にはありません。

可能であれば、EF6 からの以前の移行がすべてデータベースに適用されていることを前提に、EF Core を使用してその時点からスキーマの移行を開始することをお勧めします。 これを行うには、モデルが EF Core に移植された後に Add-Migration コマンドを使用して移行を追加します。 次に、スキャフォールディング移行の Up と Down のメソッドからすべてのコードを削除します。 その後の移行では、最初の移行がスキャフォールディングされたときにモデルと比較されます。

移植をテストする

アプリケーションでコンパイルされるからといって、EF Core に正常に移植されるわけではありません。 アプリケーションのすべての領域をテストして、どの動作変更もアプリケーションに悪影響を与えないことを確認する必要があります。

最後に、コード内の特定のケースやシナリオについてより多くのアドバイスを得るために 移植する際に考慮する必要のある詳細なケースを確認します。