从 ASP.NET Core 3.0 迁移到 3.1Migrate from ASP.NET Core 3.0 to 3.1

本文介绍如何将现有 ASP.NET Core 3.0 项目更新为 ASP.NET Core 3.1。

Visual Studio Code 说明使用用于 ASP.NET Core 的 .NET Core CLI 开发功能,如项目创建。可在任何平台(macOS、Linux 或 Windows)上或在任何代码编辑器中遵循这些说明。如果使用 Visual Studio Code 以外的其他内容,则可能需要进行少量更改。

在 global.json 中更新 .NET Core SDK 版本Update .NET Core SDK version in global.json

如果依赖于全局 json文件来面向特定的 .NET Core SDK 版本,请将 属性更新为安装的 3.1 SDK 版本。例如:

更新包引用Update package references

在项目文件中,将每个 包引用的 Version 属性更新为3.1.0 或更高版本。例如:

对于使用 Docker 的应用,请使用包含 ASP.NET Core 3.1 的基本映像。例如:

响应 SameSite cookie 更改React to SameSite cookie changes

HTTP cookie 特性实现在 ASP.NET Core 3.0 和3.1 之间发生了更改。要执行的操作,请参阅以下资源:

可选更改Optional changes

以下更改是可选的。

使用组件标记帮助程序Use the Component Tag Helper

ASP.NET Core 3.1 引入了 Component 标记帮助器。标记帮助程序可以在 Blazor 项目中替换 HTML 帮助器方法。例如:

有关详细信息,请参阅将组件集成到 Razor 页面和 MVC 应用