安裝 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 。