如果要将应用迁移到 .NET 8,则此处列出的重大更改可能会影响您。 变更按技术领域分组,例如 ASP.NET Core 或 Windows 窗体。
本文将每个重大变更分类为二进制不兼容、源不兼容或行为更改:
二进制不兼容 - 针对新的运行时或组件运行时,现有二进制文件在行为上可能会遇到中断性变更,例如无法加载或执行,如果是,则需要重新编译。
源不兼容 - 使用新 SDK 或组件重新编译或面向新运行时时,现有源代码可能需要进行源更改才能成功编译。
行为更改 - 现有代码和二进制文件在运行时的行为可能有所不同。 如果不需要新的行为,则需要更新和重新编译现有代码。
ASP.NET Core
容器
| 标题 | 更改类型 |
|---|---|
| Alpine 映像中已移除“ca-certificates”包 | 二进制不兼容 |
| Debian 容器映像已升级到 Debian 12 | 二进制不兼容/行为变更 |
| 默认 ASP.NET Core端口更改为 8080 | 行为变更 |
| dotnet test 在容器中需要可写的 VSTest 项目基目录 | 行为变更 |
| 从 Alpine 和 Debian 映像中删除了 Kerberos 包 | 二进制不兼容 |
| 从 Alpine 映像中移除了 'libintl' 包 | 行为变更 |
| 多平台容器标记仅限 Linux | 行为变更 |
| Linux 镜像中的新“app”用户 | 行为变更 |
Core .NET 库
加密
| 标题 | 更改类型 | 已引入 |
|---|---|---|
| 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 中的重大更改。
插件
全球化
| 标题 | 更改类型 |
|---|---|
| 日期和时间转换器使用区域性参数 | 行为变更 |
| 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 项目反射序列化失败 | 行为变更 |
| 基于反射的反序列化程序急切地解析元数据 | 行为变更 |