EF6 的新功能

強烈建議您使用 Entity Framework 的最新發行版本，以確保您取得最新的功能和最高的穩定性。 不過，我們了解您可能需要使用先前的版本，或者可能想要體驗最新發行前版本中的新改善。 若要安裝特定版本的 EF，請參閱取得 Entity Framework。

EF 6.4.0

EF 6.4.0 執行階段已於 2019 年 12 月發行至 NuGet。 EF 6.4 的主要目標在改進 EF 6.3 提供的功能與案例。 請參閱 Github 的 重要修正清單。

EF 6.3.0

EF 6.3.0 執行階段已於 2019 年 9 月發行至 NuGet。 此版本主要目標為將使用 EF 6 的現有應用程式促進移轉至 .NET Core 3.0。 社群也貢獻了一些 Bug 修正和增強功能。 有關詳細資料，請參閱每個 6.3.0 里程碑中已關閉的問題。 以下是一些較需注意的事項：

• .NET Core 3.0 的支援
  • 現在除了 .NET Framework 4.x 以外，EntityFramework 套件也以 .NET Standard 2.1 為目標。
  • 這表示 EF 6.3 可以跨平台，在 Windows 以外的其他作業系統上獲得支援，例如 Linux 和 macOS。
  • 移轉命令已經過重寫，改為在處理序外執行，並使用 SDK 樣式的專案。
• 對 SQL Server HierarchyId 的支援。
• 已改善與 Roslyn 和 NuGet PackageReference 的相容性。
• 已新增 ef6.exe 公用程式，用於從組件啟用、新增、撰寫指令碼並套用移轉。 這取代了 migrate.exe。

EF 設計工具支援

目前不支援在 .NET Core、.NET Standard 專案或 SDK 樣式的 .NET Framework 專案中，直接使用 EF 設計工具。

您可以透過新增 EDMX 檔案與實體的產生類別和 DbContext 作為連結的檔案至相同方案中的 .NET Core 3.0 或 .NET Standard 2.1 專案來作為因應措施。

在專案檔中，連結的檔案看起來像下面這樣：

<ItemGroup>
  <EntityDeploy Include="..\EdmxDesignHost\Entities.edmx" Link="Model\Entities.edmx" />
  <Compile Include="..\EdmxDesignHost\Entities.Context.cs" Link="Model\Entities.Context.cs" />
  <Compile Include="..\EdmxDesignHost\Thing.cs" Link="Model\Thing.cs" />
  <Compile Include="..\EdmxDesignHost\Person.cs" Link="Model\Person.cs" />
</ItemGroup>

請注意，EDMX 檔案是使用 EntityDeploy 建置動作連結的。 這是特殊 MSBuild 工作 (現在包括在 EF 6.3 套件中)，它會負責新增 EF 模組到目標組件作為內嵌資源 (或將它複製為輸出資料夾中的檔案，視 EDMX 中的中繼資料成品處理設定而定)。 如需有關如何設定的詳細資訊，請參閱我們的 EDMX .NET Core 範例。

警告：請確認採用舊樣式 (亦即非 SDK 樣式) 的 .NET Framework 專案，先定義「實際」的 .edmx 檔案，再於 .sln 檔案中定義連結。 否則，當您在設計工具中開啟 .edmx 檔案時，將會出現下列錯誤訊息：「在目前針對專案指定的目標 Framework 中，無法使用 Entity Framework。 您可以變更專案的目標 Framework，或在 XmlEditor 中編輯模型。」。

過去版本

過去版本頁面包含所有舊版 EF 與每一版所引進之主要功能的封存。