Iron Suite for .NET
10 .NETライブラリ。1つの完全なドキュメントスイート。
NET 11に移行しますか? その前にこれらの互換性のない変更を確認してください
.NET 11が近づいており、互換性の破壊的変更リストがすでに公開されています。アップグレードに際して何を確認すべきかを知るために、私たちはそれを一行ずつ確認しました。
これは良いニュースですが、移行テストがより重要になることも意味します。
多くのアプリケーションは、.NET 11にリターゲットした後も問題なくコンパイルされ続けます。より大きなリスクは動作の変化です。ビルドには成功するが、新しい例外をスローしたり、データを異なる方法で処理したり、実行時にわずかに異なる結果を生成したりするコードです。
すべての互換性項目を一つ一つ確認する代わりに、このガイドでは実際のアプリケーションに影響を与える可能性が高い変更と、本番環境に移行する前にテストすべきことに焦点を当てています。
一覧表で全体を把握
| 変更点 | 発生すること |
|---|---|
| ZIP読み込みがCRC32を検証 | 破損したエントリでInvalidDataExceptionをスロー |
DateOnly/TimeOnly TryParse | 無効な形式やスタイルでスロー |
BackgroundServiceの失敗 | ホストが起動/シャットダウン時にスロー |
| Math.Roundの正確性 | 正しく丸められた結果を返す |
| 共有フレームワークの拡張 | アセンブリバージョンの解決が変わる可能性 |
| ビルドとテストツール | VSTest、NuGet、テンプレートエンジンの変更 |
最初に確認すべきもの: ZIP読み込みが今やスローする
これはドキュメントを多く扱うコードベースにとって驚きとなる可能性が高い変更です。なぜなら、それは静かにしていて、突然問題を引き起こすからです。.NET 11から、System.IO.CompressionはZIPエントリを読み込む際にCRC32チェックサムを検証し、保存されたチェックサムがデータと一致しない場合にInvalidDataExceptionをスローします。以前は、破損または改ざんされたエントリは何の問題もなく読み込まれていました。
これは本当に良い変更であり、ファイルが不正であることを知りたいものですが、ユーザー、パートナー、または古いストレージバケットからZIPファイルを取り込むアプリがある場合、何年も「動作していた」コードが突然スローし始める可能性があります。修正は簡単です: 読み込みをInvalidDataExceptionのtry-catchでラップし、不正なアーカイブをどのように処理するかを決定します。意図的にキャッチする方が、本番環境で発見するよりも良いです。
隠れた変更: TryParseが今やスローする可能性
すべての.NET開発者は、TryParseが決してスローせず、boolを返すことを理解しています。.NET 11では、DateOnly.TryParse、TimeOnly.TryParse、およびそのTryParseExactの兄弟がその習慣を少し破ります: 無効なDateTimeStyles値や不正な形式指定子を渡すと、静かにfalseを返す代わりにArgumentExceptionをスローします。形式文字列やスタイルがハードコードされていて有効であれば、何も変わりません。それらが実行時に計算されたり、ユーザー入力から来る場合、それは新しい例外パスをカバーする必要があります。
それがあなたの世界である場合のみ確認してください
残りは狭く、住んでいる場所ごとにグループ化されています:
- ASP.NET Core. 数年前に非推奨とされた古いBlazor APIはもうコンパイルされません。Kestrelは不正なHTTPヘッダーに対してより厳格です。そして、SQL接続文字列がEntra ID (
Active Directory) 認証を使用している場合、今ではMicrosoft.Data.SqlClient.Extensions.Azureパッケージが必要で、これはEF Core SQL Serverユーザーにも影響します。 - 拡張機能とホスティング. ワーカーサービスはより大きなエラーを出します:
BackgroundServiceがスローされると、ホストもスローされるので、スタートアップパスをテストしてください。 - コアライブラリ.
Math.Roundと複素数はより標準に準拠するようになり、これは古い値を期待するテストにのみ影響します。 - ビルドとツール. VSTestはNewtonsoft.Jsonを削除し、テンプレートパッケージはnetstandard2.0を削除します。これらはビルドエラーとして現れるので、自らを知らせます。
- プラットフォーム. 最小CPU要件が上がり、.NET MAUIはAndroid API 24を必要とし、TLSサーバー側の証明書取得はデフォルトでオフになっています。これらがあなたに該当するかどうかはわかるでしょう。
心配する必要がないこと
.NET 11の準備のために依存関係を監査している間、ドキュメントツールはリストに含まれないはずです。Iron Suiteライブラリは純粋なマネージド.NETであり、すでに.NET 11から.NET Frameworkまで対応しているので、IronPDF、IronXLなどのスイートはアプリと共に移動し、ブロックすることはありません。上記のZIP変更がこれらのライブラリが置き換えるファイル処理コードのすぐ隣にあることを考えると、手作りのドキュメントやアーカイブの配管がある場合、移行はその部分をすでに各.NETリリースを追跡しているライブラリに任せる自然なタイミングです。
完全なリストについては、独自のページにあるASP.NET Coreの変更を含め、Microsoft .NET 11 breaking changes referenceがブックマークするべき情報源です。このリストはまだ埋まっているので、リストが増えるにつれてこの投稿を更新します。