Instalowanie programu Entity Framework Core

  • Artykuł

Wymagania wstępne

  • Program EF wymaga najnowszego zestawu .NET SDK.

    • W czasie wykonywania program EF Core wymaga najnowszej wersji platformy .NET. Zobacz Wersje platformy EF Core, aby znaleźć minimalną wersję platformy .NET wymaganą dla wersji programu EF Core, której chcesz użyć.

  • Program EF Core umożliwia tworzenie aplikacji w systemie Windows przy użyciu programu Visual Studio. Zalecana jest najnowsza wersja programu Visual Studio .

Uzyskiwanie platformy Entity Framework Core

Program EF Core jest dostarczany jako pakiety NuGet. Aby dodać program EF Core do aplikacji, zainstaluj pakiet NuGet dla dostawcy bazy danych, którego chcesz użyć. Zobacz Dostawcy , aby uzyskać listę dostępnych dostawców baz danych.

Aby zainstalować lub zaktualizować pakiety NuGet, możesz użyć interfejsu wiersza polecenia platformy .NET Core, okna dialogowego Menedżer pakietów programu Visual Studio lub konsoli programu Visual Studio Menedżer pakietów.

Interfejs wiersza polecenia platformy .NET Core

  • Użyj następującego polecenia interfejsu wiersza polecenia platformy .NET Core z wiersza polecenia systemu operacyjnego, aby zainstalować lub zaktualizować dostawcę programu EF Core SQL Server:

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer

  • Możesz wskazać określoną wersję w poleceniu dotnet add package przy użyciu -v modyfikatora. Na przykład aby zainstalować pakiety programu EF Core 6.0.14, dołącz -v 6.0.14 do polecenia .

Aby uzyskać więcej informacji, zobacz narzędzia interfejsu wiersza polecenia platformy .NET.

Okno dialogowe Menedżer pakietów narzędzia NuGet programu Visual Studio

  • Z menu programu Visual Studio wybierz pozycję Project Manage NuGet Packages (Zarządzanie pakietami NuGet w projekcie > )

  • Kliknij kartę Przeglądaj lub Aktualizacje

  • Aby zainstalować lub zaktualizować dostawcę Microsoft.EntityFrameworkCore.SqlServer programu SQL Server, wybierz pakiet i potwierdź.

Aby uzyskać więcej informacji, zobacz Okno dialogowe Menedżer pakietów NuGet.

Konsola Menedżer pakietów NuGet programu Visual Studio

  • Z menu programu Visual Studio wybierz pozycję Narzędzia NuGet > Menedżer pakietów > konsoli Menedżer pakietów

  • Aby zainstalować dostawcę programu SQL Server, uruchom następujące polecenie w konsoli Menedżer pakietów:

    Install-Package Microsoft.EntityFrameworkCore.SqlServer

  • Aby zaktualizować dostawcę, użyj Update-Package polecenia .

  • Aby określić określoną wersję, użyj -Version modyfikatora. Na przykład aby zainstalować pakiety programu EF Core 6.0.14, dołącz -Version 6.0.14 do poleceń

Aby uzyskać więcej informacji, zobacz konsolę Menedżer pakietów.

Pobieranie narzędzi Platformy Entity Framework Core

Narzędzia do wykonywania zadań związanych z programem EF Core można instalować w projekcie, takie jak tworzenie i stosowanie migracji baz danych lub tworzenie modelu EF Core na podstawie istniejącej bazy danych.

Dostępne są dwa zestawy narzędzi:

  • Narzędzia interfejsu wiersza polecenia platformy .NET Core mogą być używane w systemach Windows, Linux lub macOS. Te polecenia zaczynają się od dotnet ef.

  • Narzędzia Menedżer pakietów Console (PMC) działają w programie Visual Studio w systemie Windows. Te polecenia zaczynają się od czasownika, na przykład Add-Migration, Update-Database.

Pobieranie narzędzi interfejsu wiersza polecenia platformy .NET Core

Narzędzia interfejsu wiersza polecenia platformy .NET Core wymagają zestawu .NET Core SDK wymienionego wcześniej w temacie Wymagania wstępne.

  • dotnet ef musi być zainstalowany jako narzędzie globalne lub lokalne. Większość deweloperów preferuje dotnet ef instalowanie jako narzędzie globalne przy użyciu następującego polecenia:

    dotnet tool install --global dotnet-ef

    dotnet ef można również użyć jako narzędzia lokalnego. Aby użyć go jako narzędzia lokalnego, przywróć zależności projektu, który deklaruje ją jako zależność narzędzi przy użyciu pliku manifestu narzędzia.

  • Aby zaktualizować narzędzia, użyj dotnet tool update polecenia .

  • Zainstaluj najnowszy Microsoft.EntityFrameworkCore.Design pakiet.

    dotnet add package Microsoft.EntityFrameworkCore.Design

Ważne

Zawsze używaj wersji pakietu narzędzi zgodnej z główną wersją pakietów środowiska uruchomieniowego.

Pobieranie narzędzi konsoli Menedżer pakietów

Aby uzyskać narzędzia konsoli Menedżer pakietów dla programu EF Core, zainstaluj Microsoft.EntityFrameworkCore.Tools pakiet. Na przykład w programie Visual Studio:

Install-Package Microsoft.EntityFrameworkCore.Tools

Uaktualnianie do najnowszej wersji programu EF Core

  • Za każdym razem, gdy udostępnimy nową wersję platformy EF Core, udostępnimy również nową wersję dostawców będących częścią projektu EF Core, na przykład Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos i Microsoft.EntityFrameworkCore.InMemory. Możesz po prostu uaktualnić do nowej wersji dostawcy, aby uzyskać wszystkie ulepszenia.

  • Jeśli musisz zaktualizować aplikację korzystającą z dostawcy bazy danych innej firmy, zawsze sprawdź aktualizację dostawcy zgodnego z wersją programu EF Core, której chcesz użyć. Na przykład dostawcy baz danych dla wersji 1.0 nie są zgodni z wersją 2.0 środowiska uruchomieniowego platformy EF Core itd.

  • Zewnętrzni dostawcy programu EF Core zwykle nie zwalniają wersji poprawek wraz ze środowiskiem uruchomieniowym EF Core. Aby uaktualnić aplikację korzystającą z dostawcy innej firmy do poprawkowej wersji programu EF Core, może być konieczne dodanie bezpośredniego odwołania do poszczególnych składników środowiska uruchomieniowego EF Core, w szczególności Microsoft.EntityFrameworkCore i Microsoft.EntityFrameworkCore.Relational.