.NET 11 中的重大变更

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

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

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

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

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

注释

本文是当前正在进行的工作。 这不是.NET 11 中重大更改的完整列表。

ASP.NET Core

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

容器

Title 更改类型
dotnet 测试需要容器中的可写 VSTest 工件基目录 行为更改

核心.NET库

Title 更改类型
当禁用堆栈跟踪支持时,Assembly.GetCallingAssembly 行为发生更改 行为更改
CborReader 和 CborWriter 强制实施默认的最大嵌套深度 行为更改
复杂的特殊值结果现在遵循 C23 附件 G 行为更改
读取 ZIP 存档条目时,新增了 CRC32 验证 行为更改
DateOnly 和 TimeOnly TryParse 方法对于无效输入会引发异常 行为更改
Decimal 和 BigInteger 浮点转换正确舍入 行为更改
DeflateStream 和 GZipStream 为空负载写入页眉和页脚 行为更改
Environment.GetCommandLineArgs()[0] 保留 apphost 调用名称 行为更改
Environment.TickCount 与Windows超时行为保持一致 行为更改
生成的 WMI 集合和枚举器包装器实现 IDisposable 源/行为变更
Math.Round 和 MathF.Round 返回正确舍入的结果 行为更改
命名互斥体在 Unix 上默认为用户作用域 行为更改
具有 PipeOptions.CurrentUserOnly 的 NamedPipeServerStream 收紧 Unix 套接字文件权限 行为更改
Nullable.GetUnderlyingType 对自定义 Type 子类引发异常 行为更改
PackagePart.GetStream() 为 ReadWrite 包中的压缩部件返回不可查找的流 行为更改
非默认诊断 ID 的 API 过时(.NET 11) 源代码不兼容
SafeFileHandle.IsAsync 和 FileStream.IsAsync 准确反映 Unix 上的非阻塞状态 行为更改
TAR 读取 API 在读取时验证标头校验和 行为更改
TarWriter 对硬链接文件使用 HardLink 条目 行为更改
张量运算对齐等效的形状和空张量 行为更改
Tensor 操作拒绝不受支持的存储布局 行为更改
ZipArchive.CreateAsync 急切地加载 ZIP 存档条目 行为更改

Cryptography

Title 更改类型
API 弃用 源代码不兼容
Windows上的复合 ML-DSA 使用本机实现 行为更改
DSA 已从 macOS 中移除 行为更改
Windows上的 HKDF 使用 CNG 实现 行为更改
Linux AIA 证书获取限制为每次构建证书链最多只进行两次 行为更改

Deployment

Title 更改类型
.runtimeconfig.dev.json 中的 configProperties 覆盖 .runtimeconfig.json 行为更改

Extensions

Title 更改类型
ChangeToken.OnChange 异步重载重新绑定现有的返回 Task 的回调 行为更改
依赖项注入范围处置聚合异常 行为更改
链式配置中的空字符串会覆盖较早的提供程序 行为更改
FileConfigurationProvider 在忽略加载失败后不会引发重载令牌 行为更改
发生 IO 错误时会调用 FileConfigurationSource.OnLoadException 回调 行为更改
当 BackgroundService 失败时,IHost.RunAsync 和 IHost.StopAsync 引发异常 行为更改
选项验证生成器针对显式 Validate 实现报告 SYSLIB1205 源代码不兼容
PhysicalFilesWatcher 验证根路径和 FileSystemWatcher 路径 行为更改
共享框架中包含的一些 Microsoft.Extensions 包 行为更改

Globalization

Title 更改类型
更正了日本日历支持的最小日期 行为更改

Interop

Title 更改类型
本机 AOT 拒绝非 blittable UnmanagedCallersOnly 签名 行为更改
NativeAOT 对 Unix 上的本机库输出使用 lib 前缀 行为更改

JIT 编译器

Title 更改类型
浮点数到小型整数类型的转换是饱和的 行为更改
最低硬件要求已更新 行为更改

网络

Title 更改类型
HttpClient 高基数指标使用可观测计数器 行为更改
默认情况下禁用 SslStream 服务器端 AIA 证书下载 行为更改

.NET MAUI

Title 更改类型
不支持 Android x86 二进制不兼容/行为变更
移动设备上的代码生成从 Mono 更改为 CoreCLR 源不兼容/行为变更
CoreCLR 取代 Mono,成为 .NET 移动应用的运行时 二进制/源不兼容/行为更改
CoreCLR 跟踪事件取代 Mono 跟踪事件 二进制/源不兼容/行为更改
移动平台上的崩溃报告行为更改 行为更改
移动平台上的调试接口更改为 ICorDebug 二进制/源不兼容/行为更改
最低 Android API 级别提高到 24 行为更改
在移动平台上不再支持 Mono 嵌入 API 二进制/源不兼容/行为更改
Mono 项目属性不再用于配置移动应用 源不兼容/行为变更
Mono 运行时设置不再用于配置移动应用 行为不兼容/源代码不兼容
Apple 目标不支持 UnwindNativeCode 源不兼容/行为变更

SDK 和 MSBuild

Title 更改类型
dnx 脚本绕过 global.json SDK 选择 行为更改
Native AOT 发布时跳过完整生成 行为更改
未为 .NET Framework 应用设置 mono 启动目标 行为更改
默认情况下启用 NativeAOT CLI 命令处理 行为更改
NU1703 针对使用已弃用 MonoAndroid 框架资产的包发出警告 源代码不兼容
NuGet 锁定目录已移至 Linux 行为更改
NuGet 包针对包含受限字符的包 ID 发出警告 行为更改
恢复不会搜索更高版本的全局包文件夹 源代码不兼容
SDK 本地容器运行时选择首选平台原生工具 行为更改
模板引擎包不再支持 netstandard2.0 二进制/源代码不兼容
模板包安装会验证 NuGet 签名 行为更改
VSTest 移除对 Newtonsoft.Json 的依赖 二进制/源代码不兼容