Windows アプリの DB 周りを調べていて、EF Core のマイグレーションがかなり便利だなと思ったので、構築手順とマイグレーション方法について記載します。

EF Core とは

公式サイトより引用です。

Entity Framework Core は、.NET 用の最新のオブジェクトデータベースマッパーです。 LINQ クエリ、変更の追跡、更新、スキーマの移行がサポートされています。 EF Core は、SQL Database (オンプレミスと Azure)、SQLite、MySQL、PostgreSQL、Azure Cosmos DB などの多くのデータベースに対応しています。

環境

Visual Studio 2019
.NET Core 3.0
EF Core 3.1.7
SQLite

手順

1. WPF アプリのプロジェクトを新規作成し、以下の NuGet パッケージをインストールする

Install-Package Microsoft.EntityFrameworkCore.Sqlite
Install-Package Microsoft.EntityFrameworkCore.Proxies
Install-Package Microsoft.EntityFrameworkCore.Tools

Microsoft.EntityFrameworkCore.SQLite（SQLite 本体）
Microsoft.EntityFrameworkCore.Proxies（データの遅延読み込みサポート用）
Microsoft.EntityFrameworkCore.Tools（マイグレーション用）

2. EF Core のチュートリアルに記載のソース（C#、XAML）を一通り書き切る（ビルドはまだしない）

私が使ったのは EF Core のチュートリアルです。
WPF の使用を開始する - EF Core | Microsoft Docs

以下にサンプルコードもあるので、手書きせずともそちらを使っても大丈夫です。
GetStartedWPF

ただし、まだビルドはしないように気をつけてください。
理由は後ほど説明します。

3. `MainWindow.xaml.cs`の`Window_Loaded`を以下の通り書き換える

MainWindow.xaml.cs

privatevoidWindow_Loaded(objectsender,RoutedEventArgse){// DBのマイグレーション_context.Database.Migrate();// load the entities into EF Core_context.Categories.Load();// bind to the sourcecategoryViewSource.Source=_context.Categories.Local.ToObservableCollection();}

具体的には、_context.Database.EnsureCreated();と書かれていたところを、_context.Database.Migrate();に書き換えます。
書き換える理由としては以下の通りです（公式ドキュメント引用）

データベースが既に存在する場合、EnsureCreated() によってデータベースのスキーマとシードデータが更新されないことに注意してください。リレーショナルデータベースの場合、移行を使用する予定がある場合は EnsureCreated() を呼び出さないでください。

ビルドをしないでください、と言ったのもこのためです。
もしビルドをしてしまった場合は、生成されたproducts.dbを削除してください。

4. パッケージマネージャーコンソールで以下のコマンドを実行し、Migrations フォルダおよびその配下に C#ファイルがいくつか自動生成されることを確認する

Add-Migration InitialCreate
Update-Database

5. ビルド&アプリを実行する

products.dbが生成されるはずです。

マイグレーションのやり方

個人的に便利だと思ったのがこのマイグレーションです。
本来ならクエリ文を手書きして適用する形でいろいろめんどくさいのですが、EF Core ではクエリ文を手書きせずとも簡単なコマンドで簡単に実現できます。

1. `Product.cs`に適当なカラムを追加するなどする

例えばProduct.csを以下のように書き換えてみます。

Product.cs

namespaceGetStartedWPF{publicclassProduct{publicintProductId{get;set;}publicstringName{get;set;}publicintPrice{get;set;}// 新しく追加したカラムpublicintCategoryId{get;set;}publicvirtualCategoryCategory{get;set;}}}

2. 以下のコマンドを実行し、Migrations フォルダの配下に C#ファイルが新たに自動生成されることを確認する

Add-Migration AddProductPrice
Update-Database

3. ビルド&アプリ実行

products.dbを見ると、1 で変更した内容が反映されているはずです。

UWP アプリで EF Core を使う際の注意

UWP アプリにて EF Core のマイグレーションをやるときは、App.xaml.csでマイグレーションしないと動かないので注意です。
WPF アプリなどを Windows アプリケーションパッケージプロジェクトでパッケージングする場合も同様です。

App.xaml.cs

publicApp(){using(vardbContext=newProductContext())dbContext.Database.Migrate();}