.NET Core 编程指南中文版 —— 7.1 迁移 -> 从 .NET Core 2.0 迁移到 2.1

从 .NET Core 2.0 迁移到 2.1

本文介绍从 .NET Core 2.0 迁移到 2.1 的基本步骤。 如果希望将 ASP.NET Core 迁移到 2.1，请参阅从 ASP.NET Core 2.0 迁移到 2.1。

有关 .NET Core 2.1 新增功能的概述，请参阅 .NET Core 2.1 的新增功能。

更新项目文件以使用 2.1 版本

• 打开项目文件（*.csproj、*.vbproj 或 *.fsproj 文件）。

• 将目标框架值从 netcoreapp2.0 更改为 netcoreapp2.1。 目标框架由 <TargetFramework> 或 <TargetFrameworks> 元素定义。

  例如，将 <TargetFramework>netcoreapp2.0</TargetFramework> 更改为 <TargetFramework>netcoreapp2.1</TargetFramework>。

• 删除在 .NET Core 2.1 SDK（v 2.1.300 或更高版本）中捆绑的工具的 <DotNetCliToolReference> 引用。 这些引用包括：

  • dotnet-watch (Microsoft.DotNet.Watcher.Tools)
  • dotnet-user-secrets (Microsoft.Extensions.SecretManager.Tools)
  • dotnet-sql-cache (Microsoft.Extensions.Caching.SqlConfig.Tools)
  • dotnet-ef (Microsoft.EntityFrameworkCore.Tools.DotNet)

  在之前的 .NET Core SDK 版本中，对项目文件中这些工具之一的引用类似于以下示例：

  <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0" />
  

  由于 .NET Core SDK 不再使用此项，因此如果仍在项目中引用了其中一个捆绑工具，则会显示如下警告：

  The tool 'Microsoft.EntityFrameworkCore.Tools.DotNet' is now included in the .NET Core SDK. Here is information on resolving this warning.

  从项目文件中删除这些工具的 <DotNetCliToolReference> 引用可解决此问题。

请参阅

• 从 ASP.NET Core 2.0 迁移到 2.1
• .NET Core 2.1 的新增功能