安装 Entity Framework Core

Prerequisites

  • EF 需要最新的 .NET SDK。

    • 在运行时,EF Core 需要最新版本的 .NET。 请参阅 EF Core 版本 ,查找要使用的 EF Core 版本所需的最小 .NET 版本。
  • 可以使用 EF Core 通过 Visual Studio 在 Windows 上开发应用程序。 建议使用最新版本的 Visual Studio 。

获取 Entity Framework Core

EF Core 作为 NuGet 包提供。 若要将 EF Core 添加到应用程序,请安装要使用的数据库提供程序的 NuGet 包。 有关可用的数据库提供程序的列表,请参阅 提供程序 。

若要安装或更新 NuGet 包,可以使用 .NET 命令行接口 (CLI)、Visual Studio 包管理器对话框或 Visual Studio 包管理器控制台。

.NET 命令行界面 (CLI)

  • 使用操作系统的命令行中的以下 .NET CLI 命令安装或更新 EF Core SQL Server 提供程序:

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer
    
  • 可以在命令dotnet add package中使用-v修饰符指示特定版本。 例如,若要安装 EF Core 6.0.14 包,请追加 -v 6.0.14 到命令。

有关详细信息,请参阅 .NET 命令行接口 (CLI) 工具。

Visual Studio NuGet 包管理器对话框

  • 从 Visual Studio 菜单中,选择“项目>管理 NuGet 包”

  • 单击“ 浏览 ”或“ 更新 ”选项卡

  • 若要安装或更新 SQL Server 提供程序,请选择包 Microsoft.EntityFrameworkCore.SqlServer 并确认。

有关详细信息,请参阅 NuGet 包管理器对话框。

Visual Studio NuGet 包管理器控制台

  • 在 Visual Studio 菜单中,选择“工具 > NuGet 包管理器> 包管理器控制台”

  • 若要安装 SQL Server 提供程序,请在包管理器控制台中运行以下命令:

    Install-Package Microsoft.EntityFrameworkCore.SqlServer
    
  • 若要更新提供程序,请使用 Update-Package 命令。

  • 若要指定特定版本,请使用 -Version 修饰符。 例如,若要安装 EF Core 6.0.14 包,请追加 -Version 6.0.14 到命令

有关详细信息,请参阅 包管理器控制台。

获取 Entity Framework Core 工具

可以安装工具以在项目中执行与 EF Core 相关的任务,例如创建和应用数据库迁移,或基于现有数据库创建 EF Core 模型。

有两组工具可用:

获取 .NET CLI 工具

.NET CLI 工具需要先决条件前面提到的 .NET SDK。

  • dotnet ef 必须作为全局或本地工具安装。 大多数开发人员偏向于使用以下命令将 dotnet ef 安装为全局工具:

    dotnet tool install --global dotnet-ef
    

    dotnet ef 还可以用作本地工具。 要将它用作本地工具,请使用工具清单文件恢复声明为工具依赖项的项目的依赖项。

  • 若要更新工具,请使用 dotnet tool update 命令。

  • 安装最新的 Microsoft.EntityFrameworkCore.Design 包。

    dotnet add package Microsoft.EntityFrameworkCore.Design
    

Important

始终使用与运行时包的主版本匹配的工具包版本。

获取包管理器控制台工具

若要获取 EF Core 的包管理器控制台工具,请安装该 Microsoft.EntityFrameworkCore.Tools 包。 例如,从 Visual Studio 开始:

Install-Package Microsoft.EntityFrameworkCore.Tools

升级至最新版本的 EF Core