安裝 Entity Framework Core

必要條件

• EF 需要最新的 .NET SDK 。

  • 在執行時間，EF Core 需要最新版本的 .NET。 請參閱 EF Core 版本 ，以尋找您想要使用之 EF Core 版本所需的最小 .NET 版本。

• 您可以與 Visual Studio 搭配使用 EF Core 來開發 Windows 上的應用程式。 建議使用最新版的 Visual Studio。

取得 Entity Framework Core

EF Core 隨附為 NuGet 套件 。 若要將 EF Core 新增至應用程式，請安裝您欲使用資料庫提供者適用的 NuGet 套件。 如需可用的資料庫提供者清單，請參閱 提供者 。

若要安裝或更新 NuGet 套件，您可以使用 .NET Core 命令列介面 (CLI)、Visual Studio 套件管理員對話方塊，或是 Visual Studio 套件管理員主控台。

.NET Core CLI

• 請從作業系統的命令列使用以下 .NET Core 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 Core 命令列介面 (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 Core 命令列介面 (CLI) 工具可在 Windows、Linux 或 macOS 上使用。 這些命令會以 dotnet ef 開頭。

• 套件管理員主控台 (PMC) 工具可在 Windows 上的 Visual Studio 中執行。 這些命令會以動詞開頭，例如 Add-Migration 和 Update-Database。

取得 .NET Core CLI 工具

.NET Core CLI 工具需要先前在必要條件中提到的 .NET Core 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
  

重要

一律使用符合執行階段套件主要版本的工具套件版本。

取得套件管理員主控台套件

若要取得 EF Core 的套件管理員主控台工具，請安裝 Microsoft.EntityFrameworkCore.Tools 套件。 例如，從 Visual Studio 安裝：

Install-Package Microsoft.EntityFrameworkCore.Tools

升級為最新的 EF Core

• 每當我們發行新版本的 EF Core 時，我們也會發行屬於 EF Core 專案的新版本提供者，例如 Microsoft.EntityFrameworkCore.SqlServer 、Microsoft.EntityFrameworkCore.Sqlite 、 Microsoft.EntityFrameworkCore.Cosmos 和 Microsoft.EntityFrameworkCore.InMemory 。 您可以僅升級為新版本的提供者，來取得所有改善。

• 如果您需要更新的應用程式是使用協力廠商資料庫提供者，則請務必檢查與您要使用之 EF Core 版本相容的提供者更新。 例如，1.0 版的資料庫提供者與 EF Core 執行時間 2.0 版不相容等等。

• EF Core 的協力廠商提供者通常不會同時發行修補程式版本與 EF Core 執行階段。 若要將使用協力廠商提供者的應用程式升級至 EF Core 的修補程式版本，您可能需要新增個別 EF Core 執行時間元件的直接參考，尤其是 Microsoft.EntityFrameworkCore 和 Microsoft.EntityFrameworkCore.Relational 。