ASP.NET Core 11 中的重大变更

如果要将应用迁移到 ASP.NET Core 11,此处列出的重大更改可能会影响你。

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

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

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

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

Title 更改类型
Blazor 当名称与浏览器事件匹配时,自定义事件注册会抛出异常 行为变更
Blazor 增强型导航不再预加载资源 行为变更
Blazor服务器端渲染将防伪验证推迟到中间件阶段 行为变更
已移除 ConcurrencyLimiter 中间件 二进制/源代码不兼容
默认情况下,宿主会发出 OpenTelemetry HTTP 语义约定标记 行为变更
HttpSys 默认启用 TLS 通道绑定令牌公开功能 行为变更
标识外部登录密钥使用序数相等比较 行为变更
Kestrel 加强对 HTTP 协议的遵循 行为变更
Microsoft.OpenApi 已升级到 3.x 源代码不兼容
已删除 MVC 兼容性选项 二进制/源代码不兼容
已删除过时 Blazor 的 API 源代码不兼容
已移除已过时的 ImageTagHelper 成员 二进制/源代码不兼容
已过时 ModelMetadataIdentity.ForProperty 重载已删除 二进制/源代码不兼容
OpenAPI 文档包括每个状态代码的所有 ProducesResponseType 条目 行为变更
当 PathBase 为空时,OpenAPI 服务器 URL 不再具有尾随斜杠 行为变更
OpenApiVersion 默认为 OpenApi3_2 行为变更
OpenID Connect max_age 验证 auth_time 行为变更
通行密钥登录强制执行电子邮件/电话确认和锁定规则 行为变更
QuickGrid 排序和分页控件呈现为链接 行为变更
响应压缩始终发出 Vary: Accept-Encoding 行为变更
SqlClient Active Directory 身份验证已移至单独的包 行为变更
WebAssemblyHostBuilder 将环境变量加载到 IConfiguration 中 行为变更