タグ: dotnet-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 の代替、現実的なロールバック計画までを扱います。

net11.0 上での Xamarin.Forms 5.0 から .NET MAUI 11 GA へのエンドツーエンド移行。csproj の書き換え、カスタムレンダラーからハンドラーへの変換、AppShell の配線、DependencyService の撤去、MessagingCenter の引退、Resizetizer アセット、実プロダクションコードを噛む落とし穴までカバーします。

EF Core 11 Preview 4 で SQL Server テンポラルテーブルに対する長年の shadow プロパティ制約が撤廃されました。PeriodStart と PeriodEnd を通常の CLR プロパティとして宣言し、強く型付けされた HasPeriodStart と HasPeriodEnd のラムダで設定できます。

.NET 11 Preview 4 により、ASP.NET Core の OpenAPI 生成は HTTP QUERY を OpenAPI 3.2 の第一級の操作として認識するようになり、3.0 と 3.1 のドキュメントには適切なフォールバックが用意されます。

HttpClient の呼び出しには Microsoft.Extensions.Http.Resilience の resilience handler を使ってください。これは HTTP を理解したデフォルト値とテレメトリを 1 行で備えた Polly そのものだからです。HttpClient ではないものを保護する場合にのみ、Polly の ResiliencePipeline を直接使ってください。

.NET 11 Preview 4 は DeflateEncoder、GZipEncoder、ZLibEncoder とそれぞれのデコーダーを提供し、Stream なしで OperationStatus を使って Span<byte> に直接圧縮できます。

.NET 11 の読み取り中心のパスでは、AsNoTracking を付けた素の EF Core は Dapper の ~5% 以内に収まります。コンパイル済みクエリはプロファイル済みの単一行ホットパスで使い、Dapper は最小のレイテンシや LINQ で表現できない SQL のためだけに使いましょう。

リクエストごとに HttpClient を new してはいけません。ライフタイム管理には IHttpClientFactory を使い、手書きのリクエストコードではなく型付きインターフェースが欲しいときに Refit を上に重ねます。素の singleton HttpClient は最も単純なケースでのみ妥当です。

新規コードには単純なサービスクラスがより良いデフォルトです。2025年7月のMediatRのライセンス変更が問題になるのは、Communityの500万ドルのしきい値を超えている場合か、RPL-1.5のcopyleftを拒否する場合だけです。pipeline behaviorsが不可欠なときはMediatRを残しましょう。