Installation d’Entity Framework Core

  • Article

Prérequis

  • EF nécessite le Kit de développement logiciel (SDK) .NET le plus récent.

    • Au moment du runtime, EF Core nécessite une version récente de .NET. Consultez les Publications EF Core pour rechercher la version .NET minimale nécessaire pour la version d’EF Core que vous souhaitez utiliser.

  • Vous pouvez utiliser EF Core pour développer des applications sur Windows à l’aide de Visual Studio. La dernière version de Visual Studio est recommandée.

Obtenir Entity Framework Core

EF Core est fourni sous forme de Packages NuGet. Pour ajouter EF Core à une application, installez le package NuGet du fournisseur de base de données à utiliser. Pour obtenir la liste des fournisseurs de base de donnée disponibles, consultez Fournisseurs.

Pour installer ou mettre à jour les packages NuGet, vous pouvez utiliser l’interface de ligne de commande (CLI) .NET Core, la boîte de dialogue Gestionnaire de package Visual Studio ou la console du Gestionnaire de package Visual Studio.

CLI .NET Core

  • Utilisez la commande CLI .NET Core suivante à partir de la ligne de commande du système d’exploitation pour installer ou mettre à jour le fournisseur EF Core SQL Server :

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer

  • Vous pouvez indiquer une version spécifique dans la commande dotnet add package, à l’aide du modificateur -v. Par exemple, pour installer des packages EF Core 6.0.14, ajoutez -v 6.0.14 à la commande.

Pour plus d’informations, consultez Outils de l’interface de ligne de commande (CLI) .NET.

Boîte de dialogue Gestionnaire de package NuGet Visual Studio

  • Dans le menu Visual Studio, sélectionnez Projet > Gérer les packages NuGet

  • Cliquez sur l’onglet Parcourir ou Mises à jour.

  • Pour installer ou mettre à jour le fournisseur SQL Server, sélectionnez le package Microsoft.EntityFrameworkCore.SqlServer et confirmez.

Pour plus d’informations, consultez Boîte de dialogue Gestionnaire de package NuGet.

Console du Gestionnaire de package NuGet Visual Studio

  • Dans le menu Visual Studio, sélectionnez Outils > Gestionnaire de package NuGet > Console du Gestionnaire de package

  • Pour installer le fournisseur SQL Server, exécutez la commande suivante dans la Console du Gestionnaire de package :

    Install-Package Microsoft.EntityFrameworkCore.SqlServer

  • Pour mettre à jour le fournisseur, utilisez la commande Update-Package.

  • Pour indiquer une version spécifique, utilisez le modificateur -Version. Par exemple, pour installer des packages EF Core 6.0.14, ajoutez -Version 6.0.14 aux commandes

Pour plus d’informations, consultez Console Gestionnaire de package.

Obtenir les outils Entity Framework Core

Vous pouvez installer des outils pour effectuer des tâches liées à EF Core dans votre projet, comme créer et appliquer des migrations de base de données, ou créer un modèle EF Core basé sur une base de données existante.

Deux ensembles d’outils sont disponibles :

Obtenir les outils CLI .NET Core

Les outils CLI .NET Core nécessitent le SDK .NET Core, mentionné précédemment dans les Prérequis.

  • dotnet ef doit être installé en tant qu’outil global ou local. La plupart des développeurs préfèrent installer dotnet ef en tant qu’outil global à l’aide de la commande suivante :

    dotnet tool install --global dotnet-ef

    dotnet ef peut également être utilisé en tant qu’outil local. Pour l’utiliser comme outil local, restaurez les dépendances d’un projet qui le déclare en tant que dépendance d’outil en utilisant un fichier manifeste d’outil.

  • Pour mettre à jour les outils, utilisez la commande dotnet tool update.

  • Installez le package Microsoft.EntityFrameworkCore.Design le plus récent.

    dotnet add package Microsoft.EntityFrameworkCore.Design

Important

Utilisez toujours la version des packages d’outils qui correspond à la version principale des packages du runtime.

Obtenir les outils de la console du Gestionnaire de package

Pour obtenir les outils de la console du Gestionnaire de package pour EF Core, installez le package Microsoft.EntityFrameworkCore.Tools. Par exemple, à partir de Visual Studio :

Install-Package Microsoft.EntityFrameworkCore.Tools

Mise à niveau vers la dernière version EF Core

  • Chaque fois que nous publions une nouvelle version d’EF Core, nous publions également une nouvelle version des fournisseurs qui font partie du projet EF Core, comme Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos et Microsoft.EntityFrameworkCore.InMemory. Vous pouvez simplement passer à la nouvelle version du fournisseur pour obtenir toutes les améliorations.

  • Si vous devez mettre à jour une application qui utilise un fournisseur de base de données tiers, recherchez toujours une mise à jour du fournisseur qui est compatible avec la version d’EF Core à utiliser. Par exemple, les fournisseurs de base de données pour la version 1.0 ne sont pas compatibles avec la version 2.0 du runtime EF Core et ainsi de suite.

  • Les fournisseurs tiers d’EF Core ne publient généralement pas de versions correctives en même temps que le runtime EF Core. Pour mettre à niveau une application qui utilise un fournisseur tiers vers une version corrective d’EF Core, il est possible que vous deviez ajouter une référence directe à des composants individuels du runtime EF Core, comme Microsoft.EntityFrameworkCore et Microsoft.EntityFrameworkCore.Relational.