Instalace Entity Framework Core

Požadavky

  • EF vyžaduje nejnovější sadu .NET SDK.

    • Ef Core za běhu vyžaduje nejnovější verzi .NET. Podívejte se na verze EF Core a vyhledejte minimální verzi .NET potřebnou pro verzi EF Core, kterou chcete použít.
  • Ef Core můžete použít k vývoji aplikací ve Windows pomocí sady Visual Studio. Doporučuje se nejnovější verze sady Visual Studio .

Získání Entity Framework Core

EF Core se dodává jako balíčky NuGet. Pokud chcete přidat EF Core do aplikace, nainstalujte balíček NuGet pro zprostředkovatele databáze, kterého chcete použít. Seznam dostupných zprostředkovatelů databáze najdete v tématu Poskytovatelé.

K instalaci nebo aktualizaci balíčků NuGet můžete použít rozhraní příkazového řádku .NET Core (CLI), dialogové okno Správce balíčků sady Visual Studio nebo konzolu Správce balíčků sady Visual Studio.

Rozhraní příkazového řádku .NET Core

  • Pomocí následujícího příkazu rozhraní příkazového řádku .NET Core z příkazového řádku operačního systému nainstalujte nebo aktualizujte poskytovatele SQL Serveru EF Core:

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer
    
  • Pomocí modifikátoru dotnet add package-v můžete v příkazu určit konkrétní verzi. Pokud chcete například nainstalovat balíčky EF Core 6.0.14, připojte -v 6.0.14 se k příkazu.

Další informace najdete v tématu Nástroje rozhraní příkazového řádku .NET (CLI).

Dialogové okno Správce balíčků NuGet sady Visual Studio

  • V nabídce sady Visual Studio vyberte Spravovat balíčky NuGet projektu > .

  • Klikněte na kartu Procházet nebo Aktualizace.

  • Pokud chcete nainstalovat nebo aktualizovat poskytovatele SQL Serveru, vyberte Microsoft.EntityFrameworkCore.SqlServer balíček a potvrďte.

Další informace najdete v dialogovém okně NuGet Správce balíčků.

Konzola Správce balíčků sady Visual Studio NuGet

  • V nabídce sady Visual Studio vyberte Nástroje > NuGet Správce balíčků > konzolu Správce balíčků.

  • Pokud chcete nainstalovat zprostředkovatele SQL Serveru, spusťte v konzole Správce balíčků následující příkaz:

    Install-Package Microsoft.EntityFrameworkCore.SqlServer
    
  • Pokud chcete zprostředkovatele aktualizovat, použijte Update-Package příkaz.

  • Pokud chcete zadat konkrétní verzi, použijte -Version modifikátor. Pokud chcete například nainstalovat balíčky EF Core 6.0.14, připojte -Version 6.0.14 se k příkazům.

Další informace najdete v tématu Správce balíčků Konzola.

Získání nástrojů Entity Framework Core

Můžete nainstalovat nástroje pro provádění úkolů souvisejících s EF Core v projektu, jako je vytváření a použití migrací databází nebo vytvoření modelu EF Core založeného na existující databázi.

K dispozici jsou dvě sady nástrojů:

  • Nástroje rozhraní příkazového řádku .NET Core (CLI) je možné použít ve Windows, Linuxu nebo macOS. Tyto příkazy začínají na dotnet ef.

  • Nástroje konzoly Správce balíčků (PMC) běží v sadě Visual Studio ve Windows. Tyto příkazy začínají slovesem, například Add-MigrationUpdate-Database.

Získání nástrojů .NET Core CLI

Nástroje rozhraní příkazového řádku .NET Core vyžadují sadu .NET Core SDK uvedenou výše v části Požadavky.

  • dotnet ef musí být nainstalován jako globální nebo místní nástroj. Většina vývojářů preferuje dotnet ef instalaci jako globální nástroj pomocí následujícího příkazu:

    dotnet tool install --global dotnet-ef
    

    dotnet ef lze také použít jako místní nástroj. Pokud ho chcete použít jako místní nástroj, obnovte závislosti projektu, které ho deklarují jako závislost nástrojů pomocí souboru manifestu nástroje.

  • K aktualizaci nástrojů použijte dotnet tool update příkaz.

  • Nainstalujte nejnovější Microsoft.EntityFrameworkCore.Design balíček.

    dotnet add package Microsoft.EntityFrameworkCore.Design
    

Důležité

Vždy používejte verzi balíčku nástrojů, která odpovídá hlavní verzi balíčků modulu runtime.

Získání nástrojů konzoly Správce balíčků

Pokud chcete získat nástroje konzoly Správce balíčků pro EF Core, nainstalujte Microsoft.EntityFrameworkCore.Tools balíček. Například ze sady Visual Studio:

Install-Package Microsoft.EntityFrameworkCore.Tools

Upgrade na nejnovější VERZI EF Core

  • Kdykoli vydáme novou verzi EF Core, vydáme také novou verzi poskytovatelů, kteří jsou součástí projektu EF Core, jako je Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos a Microsoft.EntityFrameworkCore.InMemory. Stačí upgradovat na novou verzi poskytovatele, abyste získali všechna vylepšení.

  • Pokud potřebujete aktualizovat aplikaci, která používá jiného poskytovatele databáze, vždy zkontrolujte aktualizaci poskytovatele, která je kompatibilní s verzí EF Core, kterou chcete použít. Například poskytovatelé databáze verze 1.0 nejsou kompatibilní s verzí 2.0 modulu runtime EF Core atd.

  • Poskytovatelé třetích stran pro EF Core obvykle nevyvolávejte verze oprav společně s modulem runtime EF Core. Pokud chcete upgradovat aplikaci, která používá jiného poskytovatele na verzi opravy EF Core, možná budete muset přidat přímý odkaz na jednotlivé komponenty modulu runtime EF Core, zejména Microsoft.EntityFrameworkCore a Microsoft.EntityFrameworkCore.Relational.