使用英语阅读

通过


.NET 9 中的中断性变更

如果要将应用迁移到 .NET 9,则此处列出的中断性变更可能会影响到你。 变更按技术领域分组,例如 ASP.NET Core 或 Windows 窗体。

本文将每个中断性变更分类为二进制不兼容源不兼容,或者作为行为更改

  • 二进制文件不兼容 - 当针对新的运行时或组件运行时,现有二进制文件可能会遇到行为上的中断性变更(例如加载或执行失败),如果是这样,则需要重新编译。

  • 源代码不兼容 - 当使用新的 SDK 或组件重新编译,或以新的运行时为目标时,现有源代码可能需要更改源才能成功编译。

  • 行为更改 - 现有代码和二进制文件在运行时的行为可能会有所不同。 如果不需要新的行为,则需要更新和重新编译现有代码。

备注

本文是当前正在进行的工作。 这并不是 .NET 9 中的中断性变更的完整列表。 若要查询仍处于待发布状态的中断性变更,请查看 .NET 问题

ASP.NET Core

容器

Title 更改类型 引入的版本
.NET 9 容器映像不再安装 zlib 行为变更 预览版 7

Core .NET 库

密码

标题 更改类型 引入的版本
SafeEvpPKeyHandle.DuplicateHandle 增加句柄的引用计数 行为变更 预览版 7
某些 X509Certificate2 和 X509Certificate 构造函数已过时 源不兼容 预览版 7
简化了 Windows 私钥生存期 行为变更 预览版 7

部署

标题 更改类型 引入的版本
弃用的桌面 Windows/macOS/Linux MonoVM 运行时包 源不兼容 预览版 7

Interop

标题 更改类型 引入的版本
默认情况下支持 CET 不兼容二进制 预览版 6

JIT 编译器

标题 更改类型 引入的版本
浮点数到整数转换将要饱和 行为变更 预览版 4
删除了一些 SVE API 源不兼容 RC 2

网络

SDK 和 MSBuild

标题 更改类型 引入的版本
dotnet restore 审核可传递包 行为变更 预览版 6
dotnet watch与旧框架的热重载不兼容 行为变更 RC 1
dotnet workload 命令输出更改 行为变更 预览版 1
不再记录存储库 installer 版本 行为变更 预览版 5
终端记录器为默认值 行为变更 预览版 1
.NET 9 SDK 的版本要求 源不兼容 GA
针对 .NET Standard 1.x 目标发出的警告 源不兼容 预览版 6
针对 .NET 7 目标发出的警告 源不兼容 GA

序列化

标题 更改类型 引入的版本
BinaryFormatter 始终引发 行为变更 预览版 6

Windows 窗体

标题 更改类型 引入的版本
BindingSource.SortDescriptions 不返回 null 行为变更 预览版 1
对为 null 性批注的更改 源不兼容 预览版 1
ComponentDesigner.Initialize 引发 ArgumentNullException 行为变更 预览版 1
DataGridViewRowAccessibleObject.Name 起始行索引 行为变更 预览版 1
IMsoComponent 支持为选择加入 行为变更 预览版 2
新的安全分析器 源不兼容 RC 1
如果 DataGridView 为 null,则无异常 行为变更 预览版 1
PictureBox 引发 HttpClient 异常 行为变更 预览版 6

WPF

标题 更改类型 引入的版本
GetXmlNamespaceMaps 类型更改 行为变更/源不兼容 预览版 3

另请参阅