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

时间 2019-12-06

标签 asp.net asp core 2.2 项目升级 3.0 备忘录栏目 ASP 繁體版

原文原文链接

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

TargetFramework 改成 netcoreapp3.0 docker

<TargetFramework>netcoreapp3.0</TargetFramework>

从 Web 项目（Microsoft.NET.Sdk.Web）中移除 Microsoft.AspNetCore.App 的 PackageReference json

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

对应类库项目，若是移除 Microsoft.AspNetCore.App 的引用，须要修改 .csproj 的设置，将 Microsoft.NET.Sdk 改成 Microsoft.NET.Sdk.Web ，将 OutputType 设置为 Library ，详见博问app

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>netcoreapp3.0</TargetFramework>
    <OutputType>Library</OutputType>
  </PropertyGroup>
</Project>

Program 中 WebHost 改成 Hostui

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()spa

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

.NET Core 3.0 SDK 的 docker 镜像code

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

ASP.NET Core 3.0 runtime 的 docker 镜像blog

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

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

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);

EF Core 3.0 OwnsOne 关系配置注意

builder.OwnsOne(b => b.ScoreRank, sr =>
{
    sr.ToTable("ScoreRank");
    sr.HasKey(x => x.BlogId);
    //EF Core 3.0 所需
    sr.WithOwner().HasForeignKey(x => x.BlogId);
});

EF Plus(Z.EntityFramework.Plus.EFCore) 不支持 .NET Core 3.0 ，详见博问

EFCore.BulkExtensions 也不支持 .NET Core 3.0 ，但只需修改它的1行代码就能够支持，详见博问