.NET 11 的重大變更

如果你正在將應用程式遷移到 .NET 11,這裡列出的破壞性變更可能會影響你。 變更依技術領域分類,例如 ASP.NET Core 或 Windows Forms。

本文會將每個重大變更分類為「二進位不相容」或「來源不相容」,或分類為「行為變更」:

  • 二進位不相容 ——當對新執行時或元件執行時,現有二進位檔可能會遇到行為上的破壞性變化,例如無法載入或執行,若有此情況,則需重新編譯。

  • 原始碼不相容 ——當使用新的 SDK 或元件重新編譯,或針對新的執行環境時,現有原始碼可能需要修改原始碼才能成功編譯。

  • 行為改變 ——現有程式碼與二進位檔在執行時可能有不同的行為。 如果不需要新的行為,則必須更新並重新編譯現有的程式碼。

備註

本文為進行中的作業。 這並不是 .NET 11 中所有重大變更的完整清單。

ASP.NET Core

請參閱 ASP.NET Core 11 中的重大變更。

容器

Title 變更類型
dotnet test 需要在容器中有一個可寫入的 VSTest artifacts 基底目錄 行為變更

核心 .NET 函式庫

Title 變更類型
當停用堆疊追蹤支援時,Assembly.GetCallingAssembly 的行為會改變 行為變更
CborReader 與 CborWriter 強制執行預設的最大巢狀深度 行為變更
複數特殊值結果現遵循 C23 附錄 G 行為變更
讀取 ZIP 壓縮檔條目時新增 CRC32 驗證 行為變更
DateOnly 與 TimeOnly TryParse 方法對無效輸入會擲回例外 行為變更
Decimal 與 BigInteger 的浮點轉換會正確四捨五入 行為變更
DeflateStream 與 GZipStream 會為空承載寫入標頭與頁尾 行為變更
Environment.GetCommandLineArgs()[0] 保留 apphost 的叫用名稱 行為變更
Environment.TickCount 與 Windows 逾時行為保持一致 行為變更
產生的 WMI 集合與列舉封裝器實作 IDisposable 來源/行為變更
Math.Round 與 MathF.Round 會正確回傳四捨五入的結果 行為變更
命名互斥在 Unix 上預設為使用者範圍 行為變更
具有 PipeOptions.CurrentUserOnly 的 NamedPipeServerStream 會收緊 Unix socket 檔案權限 行為變更
Nullable.GetUnderlyingType 會對自訂 Type 子類別擲回例外 行為變更
PackagePart.GetStream()會回傳一個不可定位的串流,用於 ReadWrite 套件中的壓縮元件 行為變更
API 棄用與非預設診斷 ID(.NET 11) 來源不相容
SafeFileHandle.IsAsync 與 FileStream.IsAsync 在 Unix 上準確反映非阻塞狀態 行為變更
TAR 讀取 API 會在讀取時驗證標頭校驗和 行為變更
TarWriter 對硬連結檔案使用 HardLink 條目 行為變更
張量運算將等效形狀和空張量對齊 行為變更
張量運算會拒絕不支援的儲存佈局 行為變更
ZipArchive.CreateAsync 立即載入 ZIP 壓縮檔項目 行為變更

Cryptography

Title 變更類型
API 的淘汰 來源不相容
Windows 上的複合 ML-DSA 採用原生實作 行為變更
DSA 已從 macOS 中移除 行為變更
Windows 上的 HKDF 採用 CNG 實作 行為變更
Linux AIA 憑證擷取每次鏈結建置僅限兩次擷取 行為變更

Deployment

Title 變更類型
.runtimeconfig.dev.json 中的 configProperties 會覆寫 .runtimeconfig.json 行為變更

擴充功能

Title 變更類型
ChangeToken.OnChange 非同步重載會重新繫結現有的 Task-returning callbacks 行為變更
依賴注入範圍處置時會彙總例外 行為變更
鏈式配置中的空字串會覆蓋先前的提供者 行為變更
FileConfigurationProvider 在忽略載入失敗後不會啟動 reload token。 行為變更
FileConfigurationSource.OnLoadException 回呼會在發生 IO 錯誤時呼叫 行為變更
當 BackgroundService 失敗時,IHost.RunAsync 與 IHost.StopAsync 會拋出例外 行為變更
選項驗證產生器會針對明確的 Validate 實作報告 SYSLIB1205 來源不相容
PhysicalFilesWatcher 驗證 root 和 FileSystemWatcher 的路徑 行為變更
部分 Microsoft.Extensions 套件包含在共用架構中 行為變更

Globalization

Title 變更類型
日本曆最小支援日期已修正 行為變更

Interop

Title 變更類型
原生 AOT 拒絕不可 blittable 的 UnmanagedCallersOnly 簽名 行為變更
NativeAOT 在 Unix 上使用 lib 前綴作為原生函式庫輸出 行為變更

JIT 編譯器

Title 變更類型
浮點數轉換為較小的整數型別時會採用飽和處理 行為變更
最低硬體需求已更新 行為變更

網路

Title 變更類型
HttpClient 高基數計量使用可觀察計數器 行為變更
SslStream 伺服器端 AIA 憑證下載預設為停用 行為變更

.NET MAUI

Title 變更類型
Android x86 不支援 二進位不相容/行為變動
行動端程式碼產生方式從 Mono 變為 CoreCLR 來源不相容/行為變更
CoreCLR 取代了 .NET 行動應用程式的 Mono 執行環境 二進位/原始碼不相容/行為改變
CoreCLR 追蹤事件取代了 Mono 追蹤事件 二進位/原始碼不相容/行為改變
行動平台的當機回報行為變更 行為變更
行動平台上的除錯介面變更成 ICorDebug 二進位/原始碼不相容/行為改變
最低 Android API 級別提升至 24 行為變更
行動平台不再支援 Mono 嵌入 API 二進位/原始碼不相容/行為改變
Mono 專案屬性不再用於設定行動應用程式 來源不相容/行為變更
Mono 執行階段設定不再為行動應用程式進行設定 行為/來源不相容
UnwindNativeCode 在 Apple 目標平台上不被支援 來源不相容/行為變更

SDK 和 MSBuild

Title 變更類型
dnx scripts 會略過 global.json 的 SDK 選取 行為變更
.NET Framework 應用程式的 mono 啟動目標未設定 行為變更
NativeAOT CLI 指令處理預設已啟用 行為變更
NU1703 會對使用已棄用 MonoAndroid 框架資產的套件提出警告 來源不相容
Linux 上的 NuGet 鎖定目錄已移動 行為變更
NuGet 套件對於有限制字元的套件 ID 會發出警告 行為變更
還原不會搜尋全域套件資料夾中的更高版本 來源不相容
SDK 本地容器執行時選擇偏好平台原生工具 行為變更
模板引擎套件不再支援 netstandard2.0 二進位/來源不相容
模板套件安裝會驗證 NuGet 簽名 行為變更
VSTest 移除對 Newtonsoft.Json 的依賴 二進位/來源不相容