Entity Framework Core installeren

Prerequisites

• EF vereist de meest recente .NET SDK.

  • Tijdens runtime vereist EF Core een recente versie van .NET. Zie EF Core-releases om de minimale .NET-versie te vinden die nodig is voor de versie van EF Core die u wilt gebruiken.

• U kunt EF Core gebruiken om toepassingen in Windows te ontwikkelen met Visual Studio. De nieuwste versie van Visual Studio wordt aanbevolen.

Entity Framework Core ophalen

EF Core wordt geleverd als NuGet-pakketten. Als u EF Core wilt toevoegen aan een toepassing, installeert u het NuGet-pakket voor de databaseprovider die u wilt gebruiken. Zie Providers voor een lijst met de beschikbare databaseproviders.

Als u NuGet-pakketten wilt installeren of bijwerken, kunt u de .NET-opdrachtregelinterface (CLI), het dialoogvenster Visual Studio Package Manager of de Visual Studio Package Manager-console gebruiken.

.NET CLI

• Gebruik de volgende .NET CLI-opdracht vanaf de opdrachtregel van het besturingssysteem om de EF Core SQL Server-provider te installeren of bij te werken:

  dotnet add package Microsoft.EntityFrameworkCore.SqlServer
  

• U kunt een specifieke versie in de dotnet add package opdracht aangeven met behulp van de -v wijzigingsfunctie. Als u bijvoorbeeld EF Core 6.0.14-pakketten wilt installeren, voegt u deze toe -v 6.0.14 aan de opdracht.

Zie .NET-opdrachtregelinterfaceprogramma's (CLI) voor meer informatie.

Dialoogvenster Visual Studio NuGet Package Manager

• Selecteer In het menu van Visual Studio Project > Manage NuGet-pakketten

• Klik op het tabblad Bladeren of Het tabblad Updates

• Als u de SQL Server-provider wilt installeren of bijwerken, selecteert u het Microsoft.EntityFrameworkCore.SqlServer pakket en bevestigt u dit.

Zie het dialoogvenster NuGet Package Manager voor meer informatie.

Visual Studio NuGet Package Manager-console

• Selecteer Tools > NuGet Package Manager Package Manager Package Manager > Console in het menu van Visual Studio

• Voer de volgende opdracht uit in de Package Manager-console om de SQL Server-provider te installeren:

  Install-Package Microsoft.EntityFrameworkCore.SqlServer
  

• Gebruik de opdracht om de provider bij te Update-Package werken.

• Als u een specifieke versie wilt opgeven, gebruikt u de -Version wijzigingsfunctie. Als u bijvoorbeeld EF Core 6.0.14-pakketten wilt installeren, voegt u deze toe -Version 6.0.14 aan de opdrachten

Zie Package Manager Console voor meer informatie.

De Entity Framework Core-hulpprogramma's ophalen

U kunt hulpprogramma's installeren voor het uitvoeren van EF Core-gerelateerde taken in uw project, zoals het maken en toepassen van databasemigraties, of het maken van een EF Core-model op basis van een bestaande database.

Er zijn twee sets hulpprogramma's beschikbaar:

• De .NET-opdrachtregelinterfaceprogramma's (CLI) kunnen worden gebruikt in Windows, Linux of macOS. Deze opdrachten beginnen met dotnet ef.

• De PMC-hulpprogramma's (Package Manager Console) worden uitgevoerd in Visual Studio in Windows. Deze opdrachten beginnen met een werkwoord, bijvoorbeeld Add-MigrationUpdate-Database.

De .NET CLI-hulpprogramma's ophalen

.NET CLI-hulpprogramma's vereisen de .NET SDK, eerder vermeld in vereisten.

• dotnet ef moet worden geïnstalleerd als een globaal of lokaal hulpprogramma. De meeste ontwikkelaars geven de voorkeur aan het installeren van dotnet ef als een globaal hulpprogramma met behulp van de volgende opdracht:

  dotnet tool install --global dotnet-ef
  

  dotnet ef kan ook worden gebruikt als een lokaal hulpprogramma. Als u het als een lokaal hulpprogramma wilt gebruiken, herstelt u de afhankelijkheden van een project dat het als hulpprogramma-afhankelijkheid declareert met behulp van een manifestbestand van het hulpprogramma.

• Gebruik de opdracht om de hulpprogramma's bij te dotnet tool update werken.

• Installeer het nieuwste Microsoft.EntityFrameworkCore.Design pakket.

  dotnet add package Microsoft.EntityFrameworkCore.Design
  

De Package Manager Console-hulpprogramma's downloaden

Installeer het Microsoft.EntityFrameworkCore.Tools pakket om de Package Manager Console-hulpprogramma's voor EF Core op te halen. Bijvoorbeeld vanuit Visual Studio:

Install-Package Microsoft.EntityFrameworkCore.Tools

Upgraden naar de nieuwste EF Core

• Telkens wanneer we een nieuwe versie van EF Core vrijgeven, brengen we ook een nieuwe versie uit van de providers die deel uitmaken van het EF Core-project, zoals Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos en Microsoft.EntityFrameworkCore.InMemory. U kunt gewoon upgraden naar de nieuwe versie van de provider om alle verbeteringen op te halen.

• Als u een toepassing wilt bijwerken die gebruikmaakt van een databaseprovider van derden, moet u altijd controleren op een update van de provider die compatibel is met de versie van EF Core die u wilt gebruiken. Databaseproviders voor versie 1.0 zijn bijvoorbeeld niet compatibel met versie 2.0 van de EF Core-runtime, enzovoort.

• Externe providers voor EF Core geven doorgaans geen patchversies uit naast de EF Core-runtime. Als u een toepassing wilt upgraden die gebruikmaakt van een externe provider naar een patchversie van EF Core, moet u mogelijk een directe verwijzing toevoegen naar afzonderlijke EF Core-runtimeonderdelen, met name Microsoft.EntityFrameworkCore en Microsoft.EntityFrameworkCore.Relational.