.NET 9 中的中断性变更

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

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

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

  • 源不兼容 - 使用新 SDK 或组件重新编译或面向新运行时时,现有源代码可能需要进行源更改才能成功编译。

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

ASP.NET Core

请参阅 ASP.NET Core 9 中的重大更改。

容器

标题 更改类型 引入的版本
容器映像不再安装 zlib 行为变更 预览版 7
dotnet 测试需要容器中的可写 VSTest 工件基础目录 行为变更 9.0.124/9.0.321
.NET Monitor 映像简化为仅使用版本标签 行为变更 预览版 5

Core .NET 库

标题 更改类型 引入的版本
使用 CompressionLevel 添加 ZipArchiveEntry 会设置 ZIP 中央目录标头常规用途位标志 行为变更 预览版 5
更改了对非开放泛型的 UnsafeAccessor 支持 行为变更 预览版 6
使用自定义诊断 ID 的 API 过时 源不兼容 (多个)
影响 StringValues 隐式运算符的不明确重载解析 源不兼容 GA
BigInteger 最大长度 行为更改 预览版 6
BinaryReader.ReadString() 在格式不正确的序列上返回“\uFFFD” 行为变更 预览版 7
C# 重载解析首选 params 跨度类型重载 源不兼容
不允许创建 System.Void 的数组类型 行为变更 预览版 1
标记为 InlineArrayAttribute 的类型的默认 Equals() 和 GetHashCode() 会引发异常 行为变更 预览版 6
EnumConverter 验证已注册的类型是否为枚举类型 行为变更 预览版 7
FromKeyedServicesAttribute 不再注入非键化参数 行为变更 RC 1
IncrementingPollingCounter 初始回调是异步的 行为变更 RC 1
内联数组结构大小限制已强制执行 行为变更 预览版 1
InMemoryDirectoryInfo 将 rootDir 添加到文件名前面 行为变更 预览版 1
命名互斥体在 Unix 上默认为用户作用域 行为变更 9.0.21
接受整数参数的新 TimeSpan.From*() 重载 源不兼容 预览版 3
某些 OOB 包的新版本 源不兼容 预览版 5
RuntimeHelpers.GetSubArray 返回不同的类型 行为变更 预览版 1
String.Trim(params ReadOnlySpan<char>) 重载已删除 源/二进制不兼容 GA
支持空环境变量 行为变更 预览版 6
ZipArchiveEntry 名称和注释遵循 UTF8 标志 行为变更 RC 1

密码学

标题 更改类型 引入的版本
从 System.Security.Cryptography.Pkcs netstandard2.0 中删除的 API 源不兼容 GA
SafeEvpPKeyHandle.DuplicateHandle up-refs handle 行为变更 预览版 7
某些 X509Certificate2 和 X509Certificate 构造函数已过时 源不兼容 预览版 7
简化Windows私钥生存期 行为变更 预览版 7

部署

标题 更改类型 引入版本
弃用的桌面Windows/macOS/Linux MonoVM 运行时包 源不兼容 预览版 7
环境变量在应用运行时配置设置中具有更高优先级 行为变更 GA

Entity Framework Core

请查看 EF Core 9 中的重大变更。

互操作

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

JIT 编译器

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

网络

标题 更改类型 引入的版本
无条件报告 HttpClient 指标server.port 行为变更 预览版 7
默认情况下,HttpClientFactory 日志记录会隐藏标头值 行为变更 RC 1
HttpClientFactory 使用 SocketsHttpHandler 作为主处理程序 行为变更 预览版 6
HttpListenerRequest.UserAgent 可为 null 源不兼容 预览版 1
HttpClient EventSource 事件中的 URI 查询脱敏 行为变更 预览版 7
IHttpClientFactory 日志中的 URI 查询修订 行为变更 预览版 7

SDK 和 MSBuild

标题 更改类型 引入的版本
dotnet sln add 不允许无效的文件名 行为变更 9.0.2xx
dotnet watch与旧框架的热重载不兼容 行为变更 RC 1
dotnet workload 命令输出更改 行为变更 预览版 1
installer 存储库版本不再有文档说明 行为变化 预览版 5
MSBuild 自定义区域性资源处理 行为变更 9.0.200/9.0.300
面向 .NET Framework 时使用的新默认 RID 源不兼容 GA
终端记录器为默认值 行为变更 预览版 1
模板包安装验证 NuGet 签名 行为变更 9.0.1xx/9.0.3xx 维护
.NET 9 SDK 的版本要求 源不兼容 GA
针对 .NET Standard 1.x 目标发出的警告 源不兼容 预览版 6
针对 .NET 7 目标发出的警告 源不兼容 GA

序列化

标题 更改类型 引入版本
BinaryFormatter 始终引发异常 行为变更 预览版 6
可为 Null 的 JsonDocument 属性反序列化为 JsonValueKind.Null 行为变更 预览版 1
System.Text.Json 元数据读取器现在会对元数据属性名称进行反转义 行为变更 GA

Windows 窗体

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

WPF

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

另请参阅