Installazione di Entity Framework Core

  • Articolo

Prerequisiti

  • EF richiede l'SDK .NET più recente.

    • In fase di esecuzione, EF Core richiede una versione recente di .NET. Vedere le versioni di EF Core per trovare la versione minima di .NET necessaria per la versione di EF Core che si vuole usare.

  • È possibile usare EF Core per lo sviluppo di applicazioni in Windows con Visual Studio. È consigliata l'ultima versione di Visual Studio.

Ottenere Entity Framework Core

EF Core viene fornito come pacchetti NuGet. Per aggiungere EF Core a un'applicazione, installare il pacchetto NuGet del provider di database da usare. Vedere Provider per un elenco dei provider di database disponibili.

Per installare o aggiornare i pacchetti NuGet, è possibile usare l'interfaccia della riga di comando di .NET Core, la finestra di dialogo Gestione pacchetti di Visual Studio o la console di Gestione pacchetti di Visual Studio.

Interfaccia della riga di comando di .NET Core

  • Usare il comando di interfaccia della riga di comando di .NET Core seguente dalla riga di comando del sistema operativo per installare o aggiornare il provider di EF Core SQL Server:

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer

  • È possibile indicare una versione specifica nel comando dotnet add package mediante il modificatore -v. Ad esempio, per installare pacchetti EF Core 6.0.14, aggiungere -v 6.0.14 al comando .

Per altre informazioni, vedere Strumenti dell'interfaccia della riga di comando (CLI) di .NET .

Finestra di dialogo Gestione pacchetti NuGet in Visual Studio

  • Dal menu di Visual Studio selezionare Project Manage NuGet Packages (Gestisci pacchetti NuGet)>

  • Fare clic sulla scheda Sfoglia o sulla scheda Aggiornamenti

  • Per installare o aggiornare il provider SQL Server selezionare il pacchetto Microsoft.EntityFrameworkCore.SqlServer e confermare.

Per altre informazioni, vedere Finestra di dialogo Gestione pacchetti NuGet.

Console di Gestione pacchetti NuGet di Visual Studio

  • Dal menu di Visual Studio selezionare Strumenti > NuGet Gestione pacchetti > console Gestione pacchetti

  • Per installare il provider SQL Server eseguire il comando seguente nella console di Gestione pacchetti:

    Install-Package Microsoft.EntityFrameworkCore.SqlServer

  • Per aggiornare il provider, usare il comando Update-Package.

  • Per indicare una versione specifica usare il modificatore -Version. Ad esempio, per installare pacchetti EF Core 6.0.14, aggiungere -Version 6.0.14 ai comandi

Per altre informazioni, vedere Console di Gestione pacchetti.

Ottenere gli strumenti di Entity Framework Core

È possibile installare gli strumenti per eseguire attività associate a EF Core nel progetto, come creare e applicare le migrazioni del database o creare un modello di EF Core basato su un database esistente.

Sono disponibili due set di strumenti:

Ottenere gli strumenti dell'interfaccia della riga di comando di .NET Core

Gli strumenti CLI di .NET core richiedono .NET Core SDK, indicato in precedenza nei Prerequisiti.

  • dotnet ef deve essere installato come strumento globale o locale. La maggior parte degli sviluppatori preferisce l'installazione dotnet ef come strumento globale usando il comando seguente:

    dotnet tool install --global dotnet-ef

    dotnet ef può essere usato anche come strumento locale. Per usarlo come strumento locale, ripristinare le dipendenze di un progetto che lo dichiara come dipendenza degli strumenti usando un file manifesto dello strumento.

  • Per aggiornare gli strumenti, usare il dotnet tool update comando .

  • Installare il pacchetto più recente Microsoft.EntityFrameworkCore.Design .

    dotnet add package Microsoft.EntityFrameworkCore.Design

Importante

Usare sempre le versioni dei pacchetti degli strumenti corrispondenti alla versione principale dei pacchetti di runtime.

Ottenere gli strumenti della console di Gestione pacchetti

Per ottenere gli strumenti della console di Gestione pacchetti per EF Core, installare il pacchetto Microsoft.EntityFrameworkCore.Tools. Ad esempio, in Visual Studio:

Install-Package Microsoft.EntityFrameworkCore.Tools

Aggiornamento alla versione più recente di EF Core

  • Ogni volta che viene rilasciata una nuova versione di EF Core, viene rilasciata anche una nuova versione dei provider che fanno parte del progetto EF Core, ad esempio Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos e Microsoft.EntityFrameworkCore.InMemory. È possibile eseguire soltanto l'aggiornamento alla nuova versione del provider per ottenere tutti i miglioramenti.

  • Se si deve aggiornare un'applicazione che usa un provider di database di terze parti, verificare sempre se è disponibile un aggiornamento del provider compatibile con la versione di Entity Framework Core che si vuole usare. Ad esempio, i provider di database per la versione 1.0 non sono compatibili con la versione 2.0 del runtime di EF Core e così via.

  • I provider di terze parti per EF Core in genere non rilasciano versioni di patch insieme al runtime di EF Core. Per aggiornare un'applicazione che usa un provider di terze parti a una versione patch di EF Core, potrebbe essere necessario aggiungere un riferimento diretto ai singoli componenti di runtime di EF Core, in particolare Microsoft.EntityFrameworkCore e Microsoft.EntityFrameworkCore.Relational.