タグ: ef-core-11

.NET 8 LTS から .NET 11 LTS へのバージョン固定の移行チェックリストです。SDK のインストール、csproj の target framework、ASP.NET Core / EF Core / System.Text.Json の破壊的変更、C# 14 のオーバーロード解決の変化、ロールバックの注意点を扱います。

2026 年に .NET Framework 4.8 のコードベースを .NET 11 LTS へ移行するための、バージョンを固定した移行プレイブック。SDK スタイル csproj への書き換え、System.Web から ASP.NET Core への移行、WCF、EF6 から EF Core 11、BinaryFormatter の削除、AppDomain の代替、現実的なロールバック計画までを扱います。

マイグレーションはランタイムの CommandTimeout ではなくデザインタイムの DbContext を使用します。UseSqlServer(o => o.CommandTimeout(...))、接続文字列の Command Timeout、または Migrate() の前の Database.SetCommandTimeout でタイムアウトを設定してください。

EF Core の設計時ツールが DbContext のインスタンスを作成できませんでした。WebApplication.CreateBuilder で host を公開するか、正しい startup project を指定するか、IDesignTimeDbContextFactory を実装してください。

EF Core 11 で N+1 クエリを見つけるための実践ガイドです。実際のコードで N+1 がどのように現れるか、ログ、診断インターセプター、OpenTelemetry を使ってどのように可視化するか、そしてホットパスがリグレッションしたときにビルドを壊すテストの書き方を解説します。

EF Core 11 のコンパイル済みクエリを実践的に解説します。EF.CompileAsyncQuery が本当に効くのはどんなときか、static フィールドのパターン、Include とトラッキングの落とし穴、追加の手間を払う価値があったと証明するためのビフォー／アフターのベンチマーク方法までを取り上げます。

EF Core は最初の DbContext アクセスで概念モデルを遅延構築するため、新しいプロセスでの最初のクエリは以後のどのクエリよりも数百ミリ秒遅くなります。本ガイドでは EF Core 11 で実用に足る三つの対策を扱います: Model に触れて接続を開く起動時の IHostedService、事前コンパイル済みモデルを出荷する dotnet ef dbcontext optimize、そして二つの対策を静かに無効化するキャッシュキーの落とし穴です。

DbContext を直接モックすると ChangeTracker が静かに壊れます。だからこそ Microsoft はそれを推奨していません。本ガイドは EF Core 11 で実際に機能する 2 つのパターンを示します。接続を開いたまま保持して本物の ChangeTracker を動かす SQLite インメモリと、テストから EF Core を完全に追い出すリポジトリパターンです。

EF Core 11 Preview 3 は RemoveDbContext、RemoveExtension、そして AddPooledDbContextFactory の引数なしオーバーロードを導入し、テストでのプロバイダー切り替え周りのボイラープレートを除去して pooled factory 設定を集約します。

EF Core 11 のクエリは IAsyncEnumerable<T> を直接実装しています。await foreach で行をストリーミングする方法、ToListAsync より好むべきタイミング、接続・トラッキング・キャンセルまわりの落とし穴。