如果您要將應用程式移轉至 .NET 10,此處列出的重大變更可能會影響您。 變更會依技術領域分組,例如 ASP.NET Core 或 Windows Forms。
本文會將每個重大變更分類為「二進位不相容」或「來源不相容」,或分類為「行為變更」:
二進位不相容 ——當對新執行時或元件執行時,現有二進位檔可能會遇到行為上的破壞性變化,例如無法載入或執行,若有此情況,則需重新編譯。
原始碼不相容 ——當使用新的 SDK 或元件重新編譯,或針對新的執行環境時,現有原始碼可能需要修改原始碼才能成功編譯。
行為改變 ——現有程式碼與二進位檔在執行時可能有不同的行為。 如果不需要新的行為,則必須更新並重新編譯現有的程式碼。
備註
本文為進行中的作業。 這不是 .NET 10 中重大變更的完整清單。
ASP.NET Core
容器
| Title | 變更類型 |
|---|---|
| 預設的 .NET 映像檔使用 Ubuntu | 行為變更 |
| dotnet 測試需要一個可寫入的 VSTest artifacts 底目錄,放在容器中 | 行為變更 |
Core .NET 程式庫
| Title | 變更類型 |
|---|---|
| API 的淘汰 | 來源不相容 |
| ActivitySource.CreateActivity 與 ActivitySource.StartActivity 行為變更 | 行為變更 |
| Arm64 SVE 非故障載入需要遮罩 | 二進位/來源不相容 |
| BufferedStream.WriteByte 不再執行隱含的刷新 | 行為變更 |
| C# 14 過載解析及 span 參數 | 行為變更 |
| 泛型數學中的一致移位行為 | 行為變更 |
| 預設追蹤上下文傳播器已更新至 W3C 標準 | 行為變更 |
| DriveInfo.DriveFormat 回傳 Linux 檔案系統類型 | 行為變更 |
| DynamicallyAccessedMembers 註解已從 DefaultValueAttribute 建構函式移除 | 二進位/來源不相容 |
| InlineArray 不允許明確的 struct Size | 二進制不相容 |
| FilePatternMatch.Stem 已改為不可空 | 來源不相容/行為變更 |
| GnuTarEntry 和 PaxTarEntry 預設不再包含 atime 和 ctime | 行為變更 |
| LDAP 目錄控制的解析現在變得更嚴格 | 行為變更 |
| MacCatalyst 版本標準化 | 行為變更 |
| 命名互斥在 Unix 上預設為使用者範圍 | 行為變更 |
| .NET 執行時不再提供預設的終止訊號處理程式 | 行為變更 |
| System.Linq.AsyncEnumerable 已包含在核心程式庫中 | 來源不相容 |
| Type.MakeGenericSignatureType 參數驗證 | 行為變更 |
Cryptography
| Title | 變更類型 |
|---|---|
| CompositeMLDsa 更新至 draft-08 | 行為變更 |
| CoseSigner.Key 可以為 null | 行為/源代碼不相容變更 |
| MLDsa 與 SlhDsa「SecretKey」成員更名 | 來源不相容 |
| macOS 不支援 OpenSSL 加密原語 | 行為變更 |
| Unix 上必須使用 OpenSSL 1.1.1 或更新版本 | 行為變更 |
| X500DistinguishedName 的驗證更為嚴格 | 行為變更 |
| X509Certificate 與 PublicKey 金鑰參數可以為空 | 行為/源代碼不相容變更 |
| 環境變數重新命名為 DOTNET_OPENSSL_VERSION_OVERRIDE | 行為變更 |
Entity Framework Core
詳見 EF Core 10中的重大變更。
Extensions
Globalization
| Title | 變更類型 |
|---|---|
| 環境變數重新命名為 DOTNET_ICU_VERSION_OVERRIDE | 行為變更 |
安裝工具
| Title | 變更類型 |
|---|---|
| 適用於 VS Code 的 dotnet.acquire API 不再總是下載最新版本 | 行為變更 |
Interop
| Title | 變更類型 |
|---|---|
| 將 IDispatchEx COM 物件投射為 IReflect 失敗 | 行為變更 |
| 單檔應用程式不再尋找執行檔目錄中的原生函式庫 | 行為變更 |
| 指定 DllImportSearchPath.AssemblyDirectory 只會搜尋組件目錄 | 行為變更 |
網路
| Title | 變更類型 |
|---|---|
| PublishTrimmed 預設關閉 HTTP/3 支援 | 來源不相容 |
| MailAddress 強制驗證連續句點 | 行為變更 |
| 瀏覽器 HTTP 用戶端預設啟用串流 HTTP 回應 | 行為變更 |
Uri 長度限制已移除 |
行為變更 |
反射
| Title | 變更類型 | 新推出的版本 |
|---|---|---|
| InvokeMember/FindMembers/DeclaredMembers 上的更多限制註解 | 行為/來源不相容 | |
| Type.MakeGenericSignatureType 參數驗證 | 行為變更 |
SDK 和 MSBuild
Serialization
| Title | 變更類型 |
|---|---|
| System.Text.Json 會檢查屬性名稱衝突 | 行為變更 |
| XmlSerializer 不再忽略標示為 ObsoleteAttribute 的屬性 | 行為變更 |
Windows Forms
Windows Presentation Foundation (WPF)
| Title | 變更類型 |
|---|---|
| 不允許空欄位定義與列定義 | 來源不相容 |
| 錯誤使用 DynamicResource 會導致應用程式當機 | 來源不相容/行為變更 |