Iron Suite for .NET
10個.NET程式庫。完整的文件套件。
遷移到 .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 永遠不會拋出,它返回一個布爾值。在 .NET 11 中,DateOnly.TryParse、TimeOnly.TryParse 及其 TryParseExact 兄弟稍微打破了這個習慣:傳遞無效的 DateTimeStyles 值或錯誤的格式規範符,它們現在拋出 ArgumentException 而不是安靜地返回 false。如果您的格式字符串和樣式是硬編碼且有效的,則不會有任何變化。如果它們是在運行時計算的或來自用戶輸入,那就是一個新的異常路徑需要覆蓋。
僅在相關時檢查
其餘的範圍較窄,按其所在位置分組:
- 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 重大變更參考 是值得加書籤的來源。我們將隨著清單的增長更新這篇文章,因為它仍在填充中。