1.10.2 EF Core .NET 命令行工具集

Entity Framework Core .NET 命令行工具集是跨平台 dotnet 命令的扩展。后者是 .NET Core SDK 的一部分。

提示

如果你正在使用 Visual Studio，我们建议你使用 PMC 工具集，因为它提供了更加完整的体验。

安装工具集

使用以下步骤可以安装 EF Core .NET 命令行工具集：

1. 编辑项目文件，将 Microsoft.EntityFrameworkCore.Tools.DotNet 作为 DotNetCliToolReference 项目添加到其中（如下所示）。

2. 在命令提示符下运行以下命令。

dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet restore

最终的项目文件看起来应该是这样的：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.EntityFrameworkCore.Design"
                      Version="2.0.0"
                      PrivateAssets="All" />
  </ItemGroup>
  <ItemGroup>
    <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet"
                            Version="2.0.0" />
  </ItemGroup>
</Project>

注意

带有 PrivateAssets="All" 的程序包引用意味着它不会被暴露到引用当前项目的其他项目中。这对于通常只在开发时使用的程序包来说尤为有用。

正常情况下，应该能够在命令提示符下成功运行以下命令了。

dotnet ef

使用工具集

任何时候只要调用命令，都会牵涉到两个项目：

目标项目是任何文件添加到的地方（一些情况是移除文件）。默认情况下目标项目就是当前目录下的项目，但是可以使用 -project 参数来临时指定另一个项目。

启动项目是执行项目代码时由工具模拟的，同样，默认情况下启动项目也是当前目录下的项目，但是可以使用 -startup-project 参数来临时指定另一个项目。

通用的参数：

提示

在运行前设置 env:ASPNETCORE_ENVIRONMENT 可以指定 ASP.NET Core 环境。

命令

dotnet ef database drop

删除数据库。

选项：

dotnet ef database update

将数据库更新到指定的迁移。

参数：

dotnet ef dbcontext info

获取 DbContext 类型的信息。

dotnet ef dbcontext list

列出可用的 DbContext 类型。

dotnet ef dbcontext scaffold

为数据库搭建 DbContext 和实体类型的基架。

参数：

选项：

dotnet ef migrations add

添加新的迁移。

参数：

选项：

dotnet ef migrations list

列出可用的迁移。

dotnet ef migrations remove

移除最近一个迁移。

选项：

dotnet ef migrations script

根据迁移（段）生成 SQL 脚本

参数：

选项：