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 與每一版所引進之主要功能的封存。