.NET 10 的重大變更

如果您要將應用程式移轉至 .NET 10,此處列出的重大變更可能會影響您。 變更會依技術領域分組,例如 ASP.NET Core 或 Windows Forms。

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

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

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

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

備註

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

ASP.NET Core

請參見 ASP.NET Core 10 中的重大變更。

容器

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

Title 變更類型
BackgroundService 將所有 ExecuteAsync 當作任務執行 行為變更
使用 AnyKey 解決 GetKeyedService() 和 GetKeyedServices() 中的問題 行為變更
配置中保留的空值 行為變更
訊息在主控台日誌輸出中不再重複 行為變更
ProviderAliasAttribute 已移至 Microsoft.Extensions.Logging.Abstractions 組件 來源不相容
已從 trim-unsafe Microsoft.Extensions.Configuration 程式碼中移除 DynamicallyAccessedMembers 註解 二進制不相容

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

Title 變更類型
.NET CLI --interactive 在使用者情境下預設為 true。 行為變更
dotnet CLI 指令會將與指令無關的資料記錄到 stderr 行為變更
.NET 工具封裝會建立 RuntimeIdentifier 特定的工具套件 行為變更
將預設工作負載設定從「鬆散資訊清單」變更為「工作負載集」模式 行為變更
DefineConstants 針對評估時無法使用的目標框架 行為變更
程式碼覆蓋範圍 EnableDynamicNativeInstrumentation 預設為 false 行為變更
dnx scripts 會略過 global.json 的 SDK 選取 行為變更
dnx.ps1 檔案已不再包含在 .NET SDK 中 來源不相容
檔案層級指令中不允許使用雙引號 來源不相容
dotnet new sln 預設為 SLNX 檔案格式 行為變更
dotnet package list 執行還原 行為變更
dotnet restore 審核傳遞相依套件 行為變更
dotnet tool install --local 預設會建立資訊清單 行為變更
dotnet watch 將日誌輸出到 stderr,而不是 stdout 行為變更
在 dotnet restore 中不支援 project.json 來源不相容
在 dotnet nuget sign 中對 SHA-1 指紋的支援已被淘汰 行為變更
MSBUILDCUSTOMBUILDEVENTWARNING 逃脫口已移除 行為變更
MSBuild 自訂文化資源處理 行為變更
NU1510 會針對被 NuGet 修剪的直接參考而引發 來源不相容
沒有執行時資產的 NuGet 套件不包含在 deps.json 來源不相容
若 PackageReference 沒有版本會產生錯誤 行為變更
PrunePackageReference 將直接可修剪的參考項設為私有 行為變更
HTTP 警告被提升為 dotnet package list 和 dotnet package search 中的錯誤 行為/源代碼不相容變更
NUGET_ENABLE_ENHANCED_HTTP_RETRY 環境變數已移除 行為變更
NuGet 審核來源預設不再允許不安全的 HTTP 行為變更
NuGet 會因套件 ID 無效而記錄錯誤 行為變更
ToolCommandName 未針對非工具套件設定 來源不相容
模板套件安裝會驗證 NuGet 簽章 行為變更

Serialization

Title 變更類型
System.Text.Json 會檢查屬性名稱衝突 行為變更
XmlSerializer 不再忽略標示為 ObsoleteAttribute 的屬性 行為變更

Windows Forms

Title 變更類型
API 的淘汰 來源不相容
同時參考 WPF 與 WinForms 的應用程式必須釐清 MenuItem 與 ContextMenu 類型 來源不相容
HtmlElement.InsertAdjacentElement 中已重新命名的參數 來源不相容
TreeView 核取方塊影像截斷 行為變更
StatusStrip 預設使用 System RenderMode 行為變更
System.Drawing OutOfMemoryException 改為 ExternalException 行為變更

Windows Presentation Foundation (WPF)

Title 變更類型
不允許空欄位定義與列定義 來源不相容
錯誤使用 DynamicResource 會導致應用程式當機 來源不相容/行為變更