安装 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