Installieren von Entity Framework Core

  • Artikel

Voraussetzungen

  • EF erfordert das neueste .NET SDK.

    • Zur Laufzeit erfordert EF Core eine aktuelle Version von .NET. Unter EF Core-Releases finden Sie die erforderliche .NET-Mindestversion für die EF Core-Version, die Sie verwenden möchten.

  • Mit EF Core können Sie in Visual Studio unter Windows Anwendungen entwickeln. Es wird empfohlen, die aktuelle Version von Visual Studio zu verwenden.

Beziehen von Entity Framework Core

EF Core wird in Form von NuGet-Paketen bereitgestellt. Installieren Sie das NuGet-Paket für den Datenbankanbieter, den Sie verwenden möchten, um einer Anwendung EF Core hinzuzufügen. Eine Liste der verfügbaren Datenbankanbieter finden Sie unter Anbieter.

Verwenden Sie die .NET Core-CLI (Command Line Interface, Befehlszeilenschnittstelle), das Dialogfeld für den Visual Studio-Paket-Manager oder die Visual Studio-Paket-Manager-Konsole, um NuGet-Pakete zu installieren oder zu aktualisieren.

.NET Core-CLI

  • Verwenden Sie den folgenden .NET Core-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

  • Mit dem Modifizierer -v können Sie eine bestimmte Version im Befehl dotnet add package angeben. Wenn Sie beispielsweise EF Core 6.0.14-Pakete installieren möchten, fügen Sie -v 6.0.14 an den Befehl an.

Weitere Informationen finden Sie unter Tools für die .NET Core-Befehlszeilenschnittstelle.

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

  • Klicken Sie im Visual Studio-Menü auf Projekt > NuGet-Pakete verwalten.

  • Klicken Sie auf Durchsuchen oder die Registerkarte Updates.

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

Weitere Informationen finden Sie im Dialogfeld des NuGet-Paket-Managers.

NuGet-Paket-Manager-Konsole (Visual Studio)

  • Wählen Sie im Visual Studio-Menü Extras > NuGet-Paket-Manager > Paket-Manager-Konsole aus.

  • Führen Sie den folgenden Befehl in der Paket-Manager-Konsole aus, um den SQL Server-Anbieter zu installieren:

    Install-Package Microsoft.EntityFrameworkCore.SqlServer

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

  • Um eine bestimmte Version anzugeben, können Sie den Modifizierer -Version verwenden. Wenn Sie beispielsweise EF Core 6.0.14-Pakete installieren möchten, fügen Sie -Version 6.0.14 an den Befehl an.

Weitere Informationen finden Sie im Artikel zur Paket-Manager-Konsole.

Installieren der Entity Framework Core-Tools

Sie können Tools installieren, die Tasks im Zusammenhang mit EF Core in Ihrem Projekt ausführen, z.B. das Erstellen und Durchführen von Datenbankmigrationen oder das Erstellen eines EF Core-Modells basierend auf einer vorhandenen Datenbank.

Es sind zwei Sätze von Tools verfügbar:

Installieren von .NET Core-CLI-Tools

.NET Core-CLI-Tools erfordern das .NET Core SDK, das bereits unter Erforderliche Komponenten 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 zum Aktualisieren der Tools den dotnet tool update-Befehl.

  • Installieren Sie das aktuelle Microsoft.EntityFrameworkCore.Design-Paket.

    dotnet add package Microsoft.EntityFrameworkCore.Design

Wichtig

Verwenden Sie immer die Toolpaketversion, die der Hauptversion der Runtimepakete entspricht.

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

Installieren Sie das Microsoft.EntityFrameworkCore.Tools-Paket, um die PMC-Tools für EF Core zu installieren. In Visual Studio sieht dies z.B. folgendermaßen aus:

Install-Package Microsoft.EntityFrameworkCore.Tools

Upgrade auf die aktuelle Version von EF Core

  • Mit jedem Release von EF Core veröffentlichen wir auch eine neue Version der Anbieter, die Teil des EF Core-Projekts sind, u. a. Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos und Microsoft.EntityFrameworkCore.InMemory. Führen Sie ein Upgrade auf die neue Version eines Anbieters durch, um alle Verbesserungen nutzen zu können.

  • Wenn Sie eine Anwendung aktualisieren müssen, die einen Datenbankanbieter eines Drittanbieters verwendet, sollten Sie immer nach einem Update des Anbieters suchen, der mit der von Ihnen gewünschten Version von EF Core kompatibel ist. Datenbankanbieter für Version 1.0 sind beispielsweise nicht mit Version 2.0 der EF Core-Runtime kompatibel.

  • Drittanbieter für EF Core veröffentlichen normalerweise keine Patchversionen mit der EF Core-Runtime. Fügen Sie einen direkten Verweis auf einzelne Komponenten der EF Core-Runtime hinzu, um eine Anwendung upzugraden, die einen Drittanbieter verwendet, um eine Version von EF Core zu patchen, vor allem Microsoft.EntityFrameworkCore und Microsoft.EntityFrameworkCore.Relational.