.NET 8 中的破坏性变更

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

本文将每个重大变更分类为二进制不兼容、源不兼容或行为更改:

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

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

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

ASP.NET Core

请参阅ASP.NET Core 8 中的重大变更。

容器

标题 更改类型
Alpine 映像中已移除“ca-certificates”包 二进制不兼容
Debian 容器映像已升级到 Debian 12 二进制不兼容/行为变更
默认 ASP.NET Core端口更改为 8080 行为变更
dotnet test 在容器中需要可写的 VSTest 项目基目录 行为变更
从 Alpine 和 Debian 映像中删除了 Kerberos 包 二进制不兼容
从 Alpine 映像中移除了 'libintl' 包 行为变更
多平台容器标记仅限 Linux 行为变更
Linux 镜像中的新“app”用户 行为变更

Core .NET 库

标题 更改类型
Null 时的活动操作名称 行为变更
AnonymousPipeServerStream.Dispose 行为 行为变更
使用自定义诊断 ID 的 API 过时 源不兼容
Unix 文件路径中的反斜杠映射 行为变更
Base64.DecodeFromUtf8 方法忽略空白字符 行为变更
已删除以布尔值为基础的枚举类型支持 行为变更
Complex.ToString 格式已更改为 <a; b> 行为变更
驱动器的当前目录路径枚举 行为变更
Enumerable.Sum 为某些输入引发新的 OverflowException 行为变更
管道关闭时的 FileStream 写入 行为变更
FindSystemTimeZoneById 不返回新对象 行为变更
GC.GetGeneration 可能会返回 Int32.MaxValue 行为变更
Unix 上的 GetFolderPath 行为 行为变更
GetSystemVersion 不再返回 ImageRuntimeVersion 行为变更
ITypeDescriptorContext 可为空注释 源不兼容
.NET Standard/.NET Framework 上不可用的 LDAP API 二进制不兼容
旧版 Console.ReadKey 已删除 行为变更
方法构建器生成参数,HasDefaultValue 设置为 false 行为变更
命名互斥体在 Unix 上默认为用户作用域 行为变更
包部件 URI 现在在 System.IO.Packaging 中以不区分大小写的方式进行比较 行为变更
UseShellExecute 为 false 时遵循 ProcessStartInfo.WindowStyle 行为变更
RuntimeIdentifier 返回为其生成运行时的平台 行为变更
对于所有无效元素类型,Type.GetType 都会引发异常 行为变更

加密

标题 更改类型 已引入
macOS 上的 AesGcm 身份验证标记大小 行为变更 预览版 1
RSA.EncryptValue 和 RSA.DecryptValue 已过时 源不兼容 预览版 1

部署

标题 更改类型
主机确定 RID 特定资源 二进制不兼容/行为变更
.NET Monitor 仅包含 distroless 映像 行为变更
openSUSE 和 SLES 的 .NET 包依赖于 OpenSSL 3.x 行为变更
StripSymbols 默认为 true 行为变更

Entity Framework Core

请参阅 EF Core 8 中的重大更改。

插件

标题 更改类型
ActivatorUtilities.CreateInstance 的行为一致 行为变更
ActivatorUtilities.CreateInstance 需要非 null 提供程序 行为变更
ConfigurationBinder 以无提示方式跳过无效的数组元素 行为变更
ConfigurationBinder 针对不匹配的值引发异常 行为变更
ConfigurationManager 包不再引用 System.Security.Permissions 源不兼容
DirectoryServices 包不再引用 System.Security.Permissions 源不兼容
配置绑定器向字典中添加空键 行为变更
FromKeyedServicesAttribute.Key 可以为 null 源不兼容
HostApplicationBuilder ctor 所尊重的 HostApplicationBuilderSettings.Args 行为变更
ManagementDateTimeConverter.ToDateTime 返回本地时间 行为变更
System.Formats.Cbor DateTimeOffset 格式更改 行为变更

全球化

标题 更改类型
日期和时间转换器使用区域性参数 行为变更
TwoDigitYearMax 默认值为 2049 行为变更

Interop

标题 更改类型
CreateObjectFlags.Unwrap 仅对目标实例取消包装 行为变更
自定义封送器需要其他成员 源不兼容
IDispatchImplAttribute API 已删除 二进制不兼容
JSFunctionBinding 隐式公共默认构造函数已删除 二进制不兼容
SafeHandle 类型必须具有公共构造函数 源不兼容
Linux 本机库解析不再使用 netcoredeps 行为变更

网络

标题 更改类型
SendFile 为无连接套接字引发 NotSupportedException 行为变更
比较 URI 中的 mailto: 用户信息 行为变更

反射

标题 更改类型
IntPtr 不再用于函数指针类型 行为变更

SDK

标题 更改类型
CLI 控制台输出使用 UTF-8 行为变更/源和二进制不兼容
完成后控制台编码不是 UTF-8 行为变更/二进制不兼容
容器默认使用“latest”标记 行为变更
“dotnet pack”使用发布配置 行为变更/源不兼容
“dotnet publish”使用发布配置 行为变更/源不兼容
-getItem、-getProperty 和 -getTargetResult 的重复输出 行为变更
不再添加对 System.Net.Http 的隐式引用using 行为变更/源不兼容
MSBuild 自定义派生生成事件已弃用 行为变更
MSBuild 遵循 DOTNET_CLI_UI_LANGUAGE 设置 行为变更
特定于运行时的应用不自包含 源代码/二进制不兼容
--arch 选项并不意味着自包含 行为变更
“dotnet restore”显示安全漏洞警告 行为变更
如果源未提供漏洞数据,“dotnet list package”将发出警告 行为变更
SDK 使用较小的 RID 图 行为变更/源不兼容
将 DebugSymbols 设置为 false 会禁用 PDB 生成 行为变更
.NET SDK 中包含的源链接 源不兼容
模板包安装验证 NuGet 签名 行为变更
裁剪不能与 .NET Standard 或 .NET Framework 一起使用 行为变更
默认情况下未为 .NET 工具安装未列出的包 行为变更
在外部构建版本中导入的 .user 文件 行为变更
.NET 8 SDK 的版本要求 源不兼容

序列化

标题 更改类型
为大多数项目禁用 BinaryFormatter 行为变更
PublishedTrimmed 项目反射序列化失败 行为变更
基于反射的反序列化程序急切地解析元数据 行为变更

Windows 窗体

标题 更改类型
在 PictureBox 中加载远程图像之前检查了证书 行为变更
DateTimePicker.Text 为空字符串 行为变更
从某些属性中删除了 DefaultValueAttribute 行为变更
ExceptionCollection ctor 引发 ArgumentException 行为变更
窗体根据 AutoScaleMode 缩放 行为变更
ImageList.ColorDepth 默认值为 Depth32Bit 行为变更
System.Windows.Extensions 不引用 System.Drawing.Common 源不兼容
TableLayoutStyleCollection 引发 ArgumentException 行为变更
顶级窗体根据 DPI 缩放最小和最大大小 行为变更
WFDEV002 已过时,现视为错误 源不兼容

另请参阅