asp.net - 从 ASP.NET Core 2.0 迁移到 3.0

Question

我在 ASP.NET Core 2.0 中有一个应用程序。我想将它升级到 ASP.NET Core 3.0。我怎样才能做到这一点？

score 11 · Accepted Answer

按照这个链接。这将为您的迁移提供一些指导。

https://docs.microsoft.com/en-us/aspnet/core/migration/22-to-30?view=aspnetcore-2.2&tabs=visual-studio

如评论中所述，从 2.0 迁移到 3.0 的完整路径是：

您将不得不一步一步地完成它们。

score 4 · Accepted Answer

stackoverflow 中这个问题的官方文档和大多数答案也有逐一升级 .NET 核心版本的步骤（2.0 -> 2.1 -> 2.2 -> 3.0 ->....）。但是由于.NET Core 3.0 已经结束了它的生命，我将给出直接从 .NET Core 2.0升级到 .NET Core 3.1(LTS) 版本的说明。

1. 将目标框架更改为 3.1

在项目文件中将 TargetFramework 更改 <TargetFramework>netcoreapp2.0</TargetFramework>为<TargetFramework>netcoreapp3.1</TargetFramework>

2) 主要变化

这些是program.cs中的变化

public static void Main(string[] args)
        {
            //BuildWebHost(args).Run(); //Remove this in your code
            CreateWebHostBuilder(args).Build().Run(); //Add this instead
        }

        //Remove this in your code
        public static IWebHost BuildWebHost(string[] args) =>
           WebHost.CreateDefaultBuilder(args)
               .UseStartup<Startup>()
               .Build();

        //Add this instead
        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
                WebHost.CreateDefaultBuilder(args)
                    .UseStartup<Startup>();

新的 Main 用 CreateWebHostBuilder 替换了对 BuildWebHost 的调用。添加了 IWebHostBuilder 以支持新的集成测试基础结构。

3) 对 Startup.cs 的更改

3.1) AddMvc() 方法

您可以看到一个名为 AddMvc() 的方法。此方法具有所有功能。因此，您可以创建任何类型的应用程序（Web API、MVC 和 Razor Pages）。即使您的应用程序不需要这些功能，它也会添加额外的功能，这可能会影响您的应用程序的性能。

   services.AddMvc(); //Remove this

反而，

如果要创建没有视图的 Web API 应用程序，请添加 services.AddControllers()
如果要使用 Razor Page 应用程序，请添加 services.AddRazorPages();
如果要开发Model View Controller（即MVC应用），添加services.AddControllersWithViews();

新方法也可以组合

3.2) Newtonsoft.Json (Json.NET) 支持

Newtonsoft.Json 已从 ASP.NET Core 共享框架中删除。现在 ASP.NET Core 的默认 JSON 序列化程序是 System.Text.Json 但如果您的应用程序已经使用它，请先安装Microsoft.AspNetCore.Mvc.NewtonsoftJson包，然后附加 .AddNewtonsoftJson(); 到新添加的MVC服务注册方法。

services.AddControllers()
    .AddNewtonsoftJson();

3.3) 路由启动代码

将 UseMvc 替换为 UseEndpoints

   //REMOVE
    //app.UseMvc(routes =>
    //{
    //    routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}");
    //});
    
    //ADD
    app.UseRouting(); //If your app calls UseStaticFiles, place UseStaticFiles before UseRouting
    app.UseEndpoints(endpoints =>
    {
       endpoints.MapControllerRoute(
               name: "default",
               pattern: "{controller=Home}/{action=Index}/{id?}");
    });

注意：对 UseAuthentication、UseAuthorization 和 UseCors 的调用必须出现在对 UseRouting 和 UseEndpoints 的调用之间才能生效

3.4) 在配置方法中，

将 IHostingEnvironment 替换为 IWebHostEnvironment

//public void Configure(IApplicationBuilder app, IHostingEnvironment env)
public void Configure(IApplicationBuilder app, IWebHostEnvironment  env)

添加 app.UseHttpsRedirection() 并为非开发环境添加 app.UseHsts();

if (env.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}
else
{
    app.UseHsts();
}

 app.UseHttpsRedirection();

4 在 global.json 中更新 .NET Core SDK 版本

如果您依赖 global.json 文件来定位特定的 .NET Core SDK 版本，请将 version 属性更新为安装的 3.1 SDK 版本

{
  "sdk": {
    "version": "3.1.101"
  }
}

5) 删除过时的包引用

大量 NuGet 包不是从 ASP.NET Core v3.0 之后的版本生成的。例如，删除 Microsoft.AspNetCore.All（从 v2.0 开始时）或 Microsoft.AspNetCore.App（从 v2.1 开始时）的包引用

**

6) 更新微软包参考

在项目文件中将 Microsoft 包引用的版本属性更新为 3.1.0 或更高版本。您也可以使用 Nuget 包管理器轻松完成此操作。