在 .NET Core 2.0 时代,项目文件中的 TargetFramework
设置为 netcoreapp2.0
,应用必须引用的库为 Microsoft.AspNetCore.All
。github
若是咱们还须要使用 Entity Framework 的工具,还须要添加工具引用。sql
<Project Sdk="Microsoft.NET.Sdk.Web"> <PropertyGroup> <TargetFramework>netcoreapp2.0</TargetFramework> </PropertyGroup> <ItemGroup> <Folder Include="wwwroot\" /> </ItemGroup> <ItemGroup> <PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.0" /> <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0" /> </ItemGroup> </Project>
可是,随着 .NET Core 2.1
的发布,微软已经建议再也不使用 Microsoft.AspNetCore.All
这个包。json
We recommend applications targeting ASP.NET Core 2.1 and later use the Microsoft.AspNetCore.App rather than this package. See Migrating from Microsoft.AspNetCore.All to Microsoft.AspNetCore.App in this article.app
对于面向 ASP.NET Core 2.1 及更高版本的应用程序,建议使用 Microsoft.AspNetCore.App 而不是此包。见文内的 从 Microsoft.AspNetCore.All 迁移到 Microsoft.AspNetCore.App框架
来源:Microsoft.AspNetCore.All metapackage for ASP.NET Core 2.0工具
在 .NET Core 2.1
中,项目文件中的TargetFramework
设置为 netcoreapp2.1
,而引用的包则变成 Microsoft.AspNetCore.App
。ui
<Project Sdk="Microsoft.NET.Sdk.Web"> <PropertyGroup> <TargetFramework>netcoreapp2.1</TargetFramework> </PropertyGroup> <ItemGroup> <PackageReference Include="Microsoft.AspNetCore.App" /> </ItemGroup> </Project>
并且,Microsoft.EntityFrameworkCore.Tools.DotNet
已经包含于 Microsoft.AspNetCore.App
以内,再也不须要单独安装。this
The .NET Core SDK version 2.1.300 and newer includes dotnet ef commands that are compatible with EF Core 2.0 and later versions. Therefore if you are using recent versions of the .NET Core SDK and the EF Core runtime, no installation is required and you can ignore the rest of this section.spa
On the other hand, the dotnet ef tool contained in .NET Core SDK version 2.1.300 and newer is not compatible with EF Core version 1.0 and 1.1. Before you can work with a project that uses these earlier versions of EF Core on a computer that has .NET Core SDK 2.1.300 or newer installed, you must also install version 2.1.200 or older of the SDK and configure the application to use that older version by modifying its global.json file. This file is normally included in the solution directory (one above the project). Then you can proceed with the installlation instruction below.
.NET Core SDK version 2.1.300 及更新版本包含了兼容 EF Core 2.0 及更新版本的 dotnet ef 命令行工具。所以,若是您使用最新版本的 .NET Core SDK 和 EF Core 运行时,将再也不须要安装此工具,您能够忽略剩下的步骤。
从另外一个方面来讲,包含于 .NET Core SDK version 2.1.300 及更新版本的 dotnet ef 工具不兼容 EF Core 1.0 和 1.1。在您于安装了 .NET Core SDK 2.1.300 或更新版本的计算机上,使用这些包含早期版本的 EF Core 项目以前,您必须还要安装 2.1.200 或者更早的 SDK ,并经过修改项目的 global.json 来配置应用程序使用早期版本。该文件一般位于解决方案文件夹中(项目的上一级)。而后能够按照以下安装指导处理。
来源:EF Core .NET Command-line Tools
下面所列出的内容包含于 Microsoft.AspNetCore.All
但不包含于 Microsoft.AspNetCore.App
包内。
Microsoft.AspNetCore.ApplicationInsights.HostingStartup
Microsoft.AspNetCore.AzureAppServices.HostingStartup
Microsoft.AspNetCore.AzureAppServicesIntegration
Microsoft.AspNetCore.DataProtection.AzureKeyVault
Microsoft.AspNetCore.DataProtection.AzureStorage
Microsoft.AspNetCore.Server.Kestrel.Transport.Libuv
Microsoft.AspNetCore.SignalR.Redis
Microsoft.Data.Sqlite
Microsoft.Data.Sqlite.Core
Microsoft.EntityFrameworkCore.Sqlite
Microsoft.EntityFrameworkCore.Sqlite.Core
Microsoft.Extensions.Caching.Redis
Microsoft.Extensions.Configuration.AzureKeyVault
Microsoft.Extensions.Logging.AzureAppServices
Microsoft.VisualStudio.Web.BrowserLink
在从 Microsoft.AspNetCore.All
迁移到 Microsoft.AspNetCore.App
时,若是您的应用使用了来自上述包或者这些包所引入的包中所提供的 API,在您的项目中添加其引用。
不会隐式包含非 Microsoft.AspNetCore.App
依赖项的上述包的任何依赖项。 例如:
StackExchange.Redis
做为 Microsoft.Extensions.Caching.Redis
的依赖
Microsoft.ApplicationInsights
做为 Microsoft.AspNetCore.ApplicationInsights.HostingStartup
的依赖
打开项目文件 ( *.csproj, *.vbproj, 或者 *.fsproj 文件)。
将 target framework 值从 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>
中删除这些引用能够修复该问题。