Installieren von Entity Framework Core

Prerequisites

• EF erfordert das neueste .NET SDK.

  • Zur Laufzeit erfordert EF Core eine aktuelle Version von .NET. Unter EF Core-Versionen finden Sie die minimale .NET-Version, die für die version von EF Core benötigt wird, die Sie verwenden möchten.

• Sie können EF Core verwenden, um Anwendungen unter Windows mit Visual Studio zu entwickeln. Die neueste Version von Visual Studio wird empfohlen.

Entity Framework Core herunterladen

EF Core wird als NuGet-Pakete ausgeliefert. Um EF Core zu einer Anwendung hinzuzufügen, installieren Sie das NuGet-Paket für den Datenbankanbieter, den Sie verwenden möchten. Eine Liste der verfügbaren Datenbankanbieter finden Sie unter "Anbieter ".

Zum Installieren oder Aktualisieren von NuGet-Paketen können Sie die Befehlszeilenschnittstelle (CLI), das Visual Studio Package Manager-Dialogfeld oder die Visual Studio Package Manager-Konsole verwenden.

.NET CLI

• Verwenden Sie den folgenden .NET CLI-Befehl über die Befehlszeile des Betriebssystems, um den EF Core SQL Server-Anbieter zu installieren oder zu aktualisieren:

  dotnet add package Microsoft.EntityFrameworkCore.SqlServer
  

• Sie können im dotnet add package-Befehl mit dem -v-Modifizierer eine bestimmte Version angeben. Um z. B. EF Core 6.0.14-Pakete zu installieren, fügen Sie -v 6.0.14 dem Befehl hinzu.

Weitere Informationen finden Sie unter .NET-Befehlszeilenschnittstellentools (CLI).

Dialogfeld für den NuGet-Paket-Manager in Visual Studio

• Wählen Sie im Visual Studio-Menü "Projekt > NuGet-Pakete verwalten" aus.

• Klicken Sie auf die Registerkarte "Durchsuchen" oder " Updates ".

• Um den SQL Server-Anbieter zu installieren oder zu aktualisieren, wählen Sie das Microsoft.EntityFrameworkCore.SqlServer Paket aus, und bestätigen Sie es.

Weitere Informationen finden Sie im Dialogfeld "NuGet-Paket-Manager".

Visual Studio NuGet Package Manager Console

• Wählen Sie im Menü "Visual Studio" die Option "Tools > NuGet Package Manager Package Manager-Paket-Manager-Konsole>" aus.

• Führen Sie zum Installieren des SQL Server-Anbieters den folgenden Befehl in der Paket-Manager-Konsole aus:

  Install-Package Microsoft.EntityFrameworkCore.SqlServer
  

• Verwenden Sie den Update-Package-Befehl, um den Anbieter zu aktualisieren.

• Verwenden Sie den -Version Modifizierer, um eine bestimmte Version anzugeben. Um beispielsweise EF Core 6.0.14-Pakete zu installieren, fügen Sie -Version 6.0.14 zu den Befehlen hinzu.

Weitere Informationen finden Sie in der Paket-Manager-Konsole.

Entity Framework Core-Tools abrufen

Sie können Tools installieren, um EF Core-bezogene Aufgaben in Ihrem Projekt auszuführen, z. B. das Erstellen und Anwenden von Datenbankmigrationen oder das Erstellen eines EF Core-Modells basierend auf einer vorhandenen Datenbank.

Es stehen zwei Toolsgruppen zur Verfügung:

• Die .NET-Befehlszeilenschnittstellentools (CLI) können unter Windows, Linux oder macOS verwendet werden. Diese Befehle beginnen mit dotnet ef.

• Die PmC-Tools (Package Manager Console) werden in Visual Studio unter Windows ausgeführt. Diese Befehle beginnen mit einem Verb, z. B. Add-Migration, Update-Database.

Holen Sie sich die .NET CLI-Tools

.NET CLI-Tools erfordern das .NET SDK, das weiter oben in "Prerequisites" erwähnt wurde.

• dotnet ef muss als globales oder lokales Tool installiert werden. Die meisten Entwickler bevorzugen das Installieren von dotnet ef als globales Tool mithilfe des folgenden Befehls:

  dotnet tool install --global dotnet-ef
  

  dotnet ef kann auch als lokales Tool verwendet werden. Für die Verwendung als lokales Tool stellen Sie die Abhängigkeiten eines Projekts wieder her, das das Tool mithilfe einer Toolmanifestdatei als Toolabhängigkeit deklariert.

• Verwenden Sie den dotnet tool update Befehl, um die Tools zu aktualisieren.

• Installieren Sie das neueste Microsoft.EntityFrameworkCore.Design Paket.

  dotnet add package Microsoft.EntityFrameworkCore.Design
  

Abrufen der Tools für die Paket-Manager-Konsole

Installieren Sie das Microsoft.EntityFrameworkCore.Tools Paket, um die Paket-Manager-Konsolentools für EF Core abzurufen. Beispiel: aus Visual Studio:

Install-Package Microsoft.EntityFrameworkCore.Tools

Upgrade auf den neuesten EF Core

• Jedes Mal, wenn wir eine neue Version von EF Core veröffentlichen, veröffentlichen wir auch eine neue Version der Anbieter, die Teil des EF Core-Projekts sind, z. B. Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos und Microsoft.EntityFrameworkCore.InMemory. Sie können einfach ein Upgrade auf die neue Version des Anbieters durchführen, um alle Verbesserungen zu erhalten.

• Wenn Sie eine Anwendung aktualisieren müssen, die einen Drittanbieter-Datenbankanbieter verwendet, suchen Sie immer nach einem Update des Anbieters, der mit der Version von EF Core kompatibel ist, die Sie verwenden möchten. Datenbankanbieter für Version 1.0 sind beispielsweise nicht kompatibel mit Version 2.0 der EF Core-Laufzeit usw.

• Drittanbieter für EF Core veröffentlichen in der Regel keine Patchversionen zusammen mit der EF Core-Laufzeit. Um eine Anwendung, die einen Drittanbieter auf eine Patchversion von EF Core verwendet, zu aktualisieren, müssen Sie möglicherweise einen direkten Verweis auf einzelne EF Core-Laufzeitkomponenten hinzufügen, vor allem Microsoft.EntityFrameworkCore und Microsoft.EntityFrameworkCore.Relational.