.NET 10 中的破坏性更改

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

本文将每个重大变更分类为“二进制不兼容”或“源不兼容”,或者作为“行为更改”:

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

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

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

注释

本文是当前正在进行的工作。 这并不是 .NET 10 中的中断性变更的完整列表。

ASP.NET Core

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

容器

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

Title 更改类型
BackgroundService 将所有 ExecuteAsync 作为任务运行 行为更改
使用 AnyKey 修复 GetKeyedService() 和 GetKeyedServices() 中的问题 行为更改
配置中保留的 Null 值 行为更改
控制台日志输出中不再重复显示消息 行为更改
ProviderAliasAttribute 已移动到 Microsoft.Extensions.Logging.Abstractions 程序集 源代码不兼容
从 trim-unsafe Microsoft.Extensions.Configuration 代码中删除了 DynamicallyAccessedMembers 批注 二进制不兼容

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

Title 更改类型
.NET CLI 在用户场景中默认使用true 行为更改
dotnet CLI 命令将非命令相关数据记录到 stderr 行为更改
.NET工具打包创建特定于 RuntimeIdentifier 的工具包 行为更改
将默认工作负荷配置从“松散清单”模式更改为“工作负荷集”模式 行为更改
DefineConstants 针对在评估时不可用的目标框架 行为更改
代码覆盖率 EnableDynamicNativeInstrumentation 默认为 false 行为更改
dnx 脚本绕过 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 源代码不兼容
SHA-1 指纹支持已弃用 dotnet nuget sign 行为更改
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 窗体

Title 更改类型
API 弃用 源代码不兼容
引用WPF和 WinForms 的应用程序必须消除 MenuItem 和 ContextMenu 类型的歧义 源代码不兼容
HtmlElement.InsertAdjacentElement 中的重命名参数 源代码不兼容
TreeView 复选框图像截断 行为更改
StatusStrip 默认使用系统 RenderMode 行为更改
System.Drawing OutOfMemoryException 已更改为 ExternalException 行为更改

Windows Presentation Foundation (WPF)

Title 更改类型
不允许空 ColumnDefinitions 和 RowDefinitions 源代码不兼容
DynamicResource 的用法不正确会导致应用程序崩溃 源不兼容/行为变更