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) 工具可用於 Windows、Linux 或 macOS。 這些命令的開頭為
dotnet ef。套件管理員控制台 (PMC) 工具會在 Windows 上的 Visual Studio 中執行。 這些命令會以動詞開頭,例如
Add-Migration,Update-Database。
取得 .NET CLI 工具
.NET CLI 工具需要稍早在 必要條件中提及的 .NET SDK。
dotnet ef必須安裝為全域或本機工具。 大部分開發人員偏好使用下列命令安裝dotnet ef為全域工具:dotnet tool install --global dotnet-efdotnet 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
每當發行新版本的 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。