如果要将应用迁移到 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 中 | 行为变更 |