.NET 5 中的重大變更

  • 發行項

若您要將應用程式移轉至 .NET 5，則可能會受此處列出的重大變更影響。 變更會依技術領域分組，例如 ASP.NET Core 或加密。

本文會表示各項中斷性變更為二進位相容或來源相容：

  • 二進位相容 - 現有的二進位檔會在不重新編譯的情況下成功載入和執行，而且執行階段行為不會變更。
  • 來源相容 - 以新執行階段為目標或使用新的 SDK 或元件時，原始程式碼會成功編譯且不會變更。

ASP.NET Core

標題 二進位相容 來源相容
ASP.NET Core 應用程式還原序列化加上引號的數字 ✔️ ❌
AzureAD.UI 與 AzureADB2C.UI API 已過時 ✔️ ❌
BinaryFormatter 序列化方法已過時 ✔️ ❌
端點路由中的資源是 HttpContext ✔️ ❌
已移除前置詞為 Microsoft 的 Azure 整合套件 ❌ ✔️
Blazor: Blazor 應用程式中的路由優先順序邏輯已變更 ✔️ ❌
Blazor：已更新瀏覽器支援 ✔️ ✔️
Blazor: 編譯器已修剪不重要的空白字元 ✔️ ❌
Blazor：JSObjectReference 與 JSInProcessObjectReference 類型為內部 ✔️ ❌
Blazor：NuGet 套件的目標 Framework 已變更 ❌ ✔️
Blazor：ProtectedBrowserStorage 功能已移至共用架構 ✔️ ❌
Blazor：RenderTreeFrame 唯讀公用欄位現在是屬性 ❌ ✔️
Blazor：已更新靜態 Web 資產的驗證邏輯 ❌ ✔️
瀏覽器不支援密碼編譯 API ❌ ✔️
延伸模組：套件參考變更 ❌ ✔️
Kestrel 與 IIS BadHttpRequestException 類型已過時 ✔️ ❌
IHttpClientFactory 記錄整數狀態碼所建立的 HttpClient 執行個體 ✔️ ❌
HttpSys：用戶端憑證重新交涉預設已停用 ✔️ ❌
IIS：UrlRewrite 中介軟體查詢字串已保留 ✔️ ❌
Kestrel: 預設會偵測到設定變更 ✔️ ❌
Kestrel：預設支援的 TLS 通訊協定版本已變更 ✔️ ❌
Kestrel：在不相容的 Windows 版本上，TLS 上的 HTTP/2 已停用 ✔️ ✔️
Kestrel：Libuv 傳輸已標示為過時 ✔️ ❌
ConsoleLoggerOptions 上的已過時屬性 ✔️ ❌
已移除 ResourceManagerWithCultureStringLocalizer 類別與 WithCulture 介面成員 ✔️ ❌
已移除「Pubternal」API ✔️ ❌
已在要求當地語系化中介軟體中移除過時的函式 ✔️ ❌
中介軟體：資料庫錯誤頁面已標示為已過時 ✔️ ❌
例外狀況處理常式中介軟體擲回原始例外狀況 ✔️ ✔️
ObjectModelValidator 呼叫驗證的新多載 ✔️ ❌
Cookie 名稱編碼已移除 ✔️ ❌
已更新 IdentityModel NuGet 套件版本 ❌ ✔️
SignalR：MessagePack 中樞通訊協定選項類型已變更 ✔️ ❌
SignalR: MessagePack 中樞通訊協定已移動 ✔️ ❌
已移除 UseSignalR 與 UseConnections 方法 ✔️ ❌
CSV 內容類型已變更為與標準相容 ✔️ ❌

程式碼分析

標題 二進位相容 來源相容
CA1416 警告 ✔️ ❌
CA1417 警告 ✔️ ❌
CA1831 警告 ✔️ ❌
CA2013 警告 ✔️ ❌
CA2014 警告 ✔️ ❌
CA2015 警告 ✔️ ❌
CA2200 警告 ✔️ ❌
CA2247 警告 ✔️ ❌

Core .NET 程式庫

標題 二進位相容 來源相容
單一檔案發佈的組件相關 API 變更 ❌ ✔️
BinaryFormatter 序列化方法已過時 ✔️ ❌
程式碼存取安全性 API 已過時 ✔️ ❌
CreateCounterSetInstance 擲回 InvalidOperationException ✔️ ❌
預設 ActivityIdFormat 為 W3C ❌ ✔️
Environment.OSVersion 傳回正確的版本 ❌ ✔️
FrameworkDescription 的值為 .NET 而不是 .NET Core ✔️ ❌
GAC API 已過時 ✔️ ❌
硬體內部 IsSupported 檢查 ❌ ✔️
IntPtr 與 UIntPtr 實作 IFormattable ✔️ ❌
LastIndexOf 處理空的搜尋字串 ❌ ✔️
Unix 上具有非 ASCII 字元的 URI 路徑 ❌ ✔️
具有非預設診斷識別碼的 API 淘汰 ✔️ ❌
ConsoleLoggerOptions 上的已過時屬性 ✔️ ❌
LINQ OrderBy.First 的複雜性 ❌ ✔️
已重新命名或移除 OSPlatform 屬性 ✔️ ❌
已移除 Microsoft.DotNet.PlatformAbstractions 套件 ❌ ✔️
PrincipalPermissionAttribute 已過時 ✔️ ❌
來自預覽版本的參數名稱變更 ✔️ ❌
參考元件中的參數名稱變更 ✔️ ❌
遠端處理 API 已過時 ❌ ✔️
Activity.Tags 的順序清單已反轉 ✔️ ❌
SSE 與 SSE2 比較方法會處理 NaN ✔️ ❌
Thread.Abort 已過時 ✔️ ❌
Unix 上 UNC 路徑的 Uri 識別 ❌ ✔️
UTF-7 程式碼路徑已過時 ✔️ ❌
Vector2.Lerp 與 Vector4.Lerp 的行為變更 ✔️ ❌
Vector<T> 擲回 NotSupportedException ❌ ✔️

密碼編譯

標題 二進位相容 來源相容
瀏覽器不支援密碼編譯 API ❌ ✔️
Cryptography.Oid 為僅限初始化 ✔️ ❌
Linux 上的預設 TLS 加密套件 ❌ ✔️
密碼編譯抽象上的 Create() 多載已過時 ✔️ ❌
預設 FeedbackSize 值已變更 ✔️ ❌

Entity Framework Core

EF Core 5.0 的中斷性變更

全球化

標題 二進位相容 來源相容
在 Windows 上使用 ICU 程式庫 ❌ ✔️
StringInfo 與 TextElementEnumerator 符合 UAX29 規範 ❌ ✔️
Latin-1 字元的 Unicode 類別已變更 ✔️ ❌
TextInfo.ListSeparator 值已變更 ✔️ ❌

Interop

標題 二進位相容 來源相容
已移除 WinRT 的支援 ❌ ✔️
將 RCW 轉換成 InterfaceIsIInspectable 會擲回例外狀況 ❌ ✔️
非 Windows 平台上沒有 A/W 尾碼探查 ❌ ✔️

網路

標題 二進位相容 來源相容
Cookie 路徑處理符合 RFC 6265 ✔️ ❌
呼叫 SendToAsync 之後，LocalEndPoint 會更新 ✔️ ❌
MulticastOption.Group 不接受 Null ✔️ ❌
串流允許後續的 Begin 作業 ❌ ✔️
已從 .NET 執行階段移除 WinHttpHandler ❌ ✔️

SDK

標題 二進位相容 來源相容
依預設匯入的 Directory.Packages.props 檔案 ❌ ✔️
可執行檔專案參考不相符可執行檔時產生的錯誤 ✔️
以 Windows SDK 的 WindowsSdkPackageVersion 取代的 FrameworkReference ✔️ ❌
未定義 NETCOREAPP3_1 前置處理器符號 ✔️ ❌
OutputType 設定為 WinExe ❌ ✔️
PublishDepsFilePath 行為變更 ❌ ✔️
TargetFramework 從 netcoreapp 變更為 net ❌ ✔️
WinForms 和 WPF 應用程式使用 Microsoft.NET.Sdk ❌ ✔️

安全性

標題 二進位相容 來源相容
程式碼存取安全性 API 已過時 ✔️ ❌
PrincipalPermissionAttribute 已過時 ✔️ ❌
UTF-7 程式碼路徑已過時 ✔️ ❌

序列化

標題 二進位相容 來源相容
BinaryFormatter.Deserialize 重新封裝例外狀況 ✔️ ❌
JsonSerializer.Deserialize 需要單一字元字串 ✔️ ❌
ASP.NET Core 應用程式還原序列化加上引號的數字 ✔️ ❌
JsonSerializer.Serialize 擲回 ArgumentNullException ✔️ ❌
非公用的無參數函式不會用於還原序列化 ✔️ ❌
序列化機碼值組時，會接受選項 ✔️ ❌

Windows Forms \(英文\)

標題 二進位相容 來源相容
機器碼無法存取 Windows Forms 物件 ✔️ ❌
OutputType 設定為 WinExe ❌ ✔️
DataGridView 不會重設自訂字型 ✔️ ❌
方法擲回 ArgumentException ✔️ ❌
方法擲回 ArgumentNullException ✔️ ❌
屬性值回 ArgumentOutOfRangeException ✔️ ❌
TextFormatFlags.ModifyString 已過時 ✔️ ❌
DataGridView API 擲回 InvalidOperationException ✔️ ❌
WinForms 應用程式使用 Microsoft.NET.Sdk ❌ ✔️
已移除狀態列控制項 ✔️ ❌

WPF

標題 二進位相容 來源相容
OutputType 設定為 WinExe ❌ ✔️
WPF 應用程式使用 Microsoft.NET.Sdk ❌ ✔️

另請參閱