如果要将应用迁移到 .NET 10,此处列出的重大更改可能会影响你。 变更按技术领域分组,例如 ASP.NET Core 或 Windows 窗体。
本文将每个重大变更分类为“二进制不兼容”或“源不兼容”,或者作为“行为更改”:
二进制不兼容 - 针对新的运行时或组件运行时,现有二进制文件在行为上可能会遇到中断性变更,例如无法加载或执行,如果是,则需要重新编译。
源不兼容 - 使用新 SDK 或组件重新编译或面向新运行时时,现有源代码可能需要进行源更改才能成功编译。
行为更改 - 现有代码和二进制文件在运行时的行为可能有所不同。 如果不需要新的行为,则需要更新和重新编译现有代码。
注释
本文是当前正在进行的工作。 这并不是 .NET 10 中的中断性变更的完整列表。
ASP.NET Core
容器
| Title | 更改类型 |
|---|---|
| 默认.NET映像使用 Ubuntu | 行为更改 |
| dotnet test 需要容器中的可写 VSTest artifacts 基目录 | 行为更改 |
Core .NET 库
| Title | 更改类型 |
|---|---|
| API 弃用 | 源代码不兼容 |
| ActivitySource.CreateActivity 和 ActivitySource.StartActivity 行为更改 | 行为更改 |
| Arm64 SVE 非故障加载需要掩码 | 二进制/源代码不兼容 |
| BufferedStream.WriteByte 不再执行隐式刷新 | 行为更改 |
| 带有 Span 参数的 C# 14 重载解析 | 行为更改 |
| 泛型数学中的一致移动行为 | 行为更改 |
| 已更新为 W3C 标准的默认跟踪上下文传播器 | 行为更改 |
| DriveInfo.DriveFormat 返回 Linux 文件系统类型 | 行为更改 |
| 已从 DefaultValueAttribute ctor 中移除 DynamicallyAccessedMembers 注解 | 二进制/源代码不兼容 |
| InlineArray 不允许显式指定的结构体 Size | 二进制不兼容 |
| FilePatternMatch.Stem 更改为不可为 null | 源不兼容/行为变更 |
| GnuTarEntry 和 PaxTarEntry 默认不再包含 atime 和 ctime | 行为更改 |
| LDAP DirectoryControl 解析现在更严格 | 行为更改 |
| 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 密钥参数可以为 null | 行为/源不兼容变更 |
| 环境变量已重命名为 DOTNET_OPENSSL_VERSION_OVERRIDE | 行为更改 |
Entity Framework Core
请参阅 EF Core 10 中的重大变更。
Extensions
Globalization
| Title | 更改类型 |
|---|---|
| 环境变量已重命名为 DOTNET_ICU_VERSION_OVERRIDE | 行为更改 |
安装工具
| Title | 更改类型 |
|---|---|
| dotnet.acquire API for VS Code 不再总是下载最新版本 | 行为更改 |
Interop
| Title | 更改类型 |
|---|---|
| 将 IDispatchEx COM 对象强制转换为 IReflect 失败 | 行为更改 |
| 单文件应用不再在可执行目录中查找本机库 | 行为更改 |
| 指定 DllImportSearchPath.AssemblyDirectory 仅搜索程序集目录 | 行为更改 |
网络
| Title | 更改类型 |
|---|---|
| 使用 PublishTrimmed 时,默认禁用 HTTP/3 支持 | 源代码不兼容 |
| MailAddress 对连续点强制实施验证 | 行为更改 |
| 默认情况下在浏览器 HTTP 客户端中启用流式处理 HTTP 响应 | 行为更改 |
Uri 已删除长度限制 |
行为更改 |
Reflection
| Title | 更改类型 | 引入的版本 |
|---|---|---|
| InvokeMember/FindMembers/DeclaredMembers 上的更多受限批注 | 行为不兼容/源代码不兼容 | |
| Type.MakeGenericSignatureType 参数验证 | 行为更改 |
SDK 和 MSBuild
Serialization
| Title | 更改类型 |
|---|---|
| System.Text.Json 检查属性名称冲突 | 行为更改 |
| XmlSerializer 不再忽略使用 ObsoleteAttribute 标记的属性 | 行为更改 |
Windows 窗体
| Title | 更改类型 |
|---|---|
| API 弃用 | 源代码不兼容 |
| 引用WPF和 WinForms 的应用程序必须消除 MenuItem 和 ContextMenu 类型的歧义 | 源代码不兼容 |
| HtmlElement.InsertAdjacentElement 中的重命名参数 | 源代码不兼容 |
| TreeView 复选框图像截断 | 行为更改 |
| StatusStrip 默认使用系统 RenderMode | 行为更改 |
| System.Drawing OutOfMemoryException 已更改为 ExternalException | 行为更改 |
Windows Presentation Foundation (WPF)
| Title | 更改类型 |
|---|---|
| 不允许空 ColumnDefinitions 和 RowDefinitions | 源代码不兼容 |
| DynamicResource 的用法不正确会导致应用程序崩溃 | 源不兼容/行为变更 |