ASP.NET Core 2.2 项目升级至 3.0 备忘录

将 ASP.NET Core 2.2 迁移至 ASP.NET Core 3.0 需要注意的地方记录在这篇随笔中。

TargetFramework 改为 netcoreapp3.0 

<TargetFramework>netcoreapp3.0</TargetFramework>

从 Web 项目（Microsoft.NET.Sdk.Web）中移除 Microsoft.AspNetCore.App 的 PackageReference ，类库项目（Microsoft.NET.Sdk）不需要移除

<PackageReference Include="Microsoft.AspNetCore.App" />

Program 中 WebHost 改为 Host

public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}

public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup<Startup>();
});
}

如果不使用 Razor Pages ，在 Startup.ConfigureServices 中将 services.AddMvc() 改为

services.AddControllers();

Startup 中 app.UseMvc() 改为 app.UseRouting() 与 app.UseEndpoints()

app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
});

 .NET Core 3.0 SDK 的 docker 镜像

mcr.microsoft.com/dotnet/core/sdk:3.0

ASP.NET Core 3.0 runtime 的 docker 镜像

mcr.microsoft.com/dotnet/core/aspnet:3.0

Web API 响应的 json 数据中文被编码的问题（详见博问）

services.AddMvc().AddNewtonsoftJson();

对于 Razor Class Library 项目，需要添加 AddRazorSupportForMvc 配置，详见博问

<AddRazorSupportForMvc>true</AddRazorSupportForMvc>

EF Core 3.0 配置一对一关系（生成 INNER JOIN SQL 语句）

builder.HasOne(p => p.ViewCount)
.WithOne()
.IsRequired()
.HasPrincipalKey<ViewCount>(vc => vc.PostId);