Installazione di Entity Framework Core

Prerequisites

• 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 sviluppare applicazioni in Windows usando Visual Studio. È consigliabile usare la versione più recente 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 per il provider di database che si vuole 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, la finestra di dialogo Gestione pacchetti di Visual Studio o la console di Gestione pacchetti di Visual Studio.

.NET CLI

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

  dotnet add package Microsoft.EntityFrameworkCore.SqlServer
  

• È possibile indicare una versione specifica nel dotnet add package comando usando il -v modificatore . 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 di .NET.

Finestra di dialogo Gestione pacchetti NuGet di Visual Studio

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

• Fare clic sulla scheda Sfoglia o Aggiornamenti

• Per installare o aggiornare il provider SQL Server, selezionare il Microsoft.EntityFrameworkCore.SqlServer pacchetto 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 > Console di Gestione > pacchetti NuGet

• 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 Update-Package comando .

• Per specificare una versione specifica, usare il -Version modificatore . 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à correlate a EF Core nel progetto, ad esempio la creazione e l'applicazione di migrazioni di database o la creazione di un modello di EF Core basato su un database esistente.

Sono disponibili due set di strumenti:

• Gli strumenti dell'interfaccia della riga di comando di .NET possono essere usati in Windows, Linux o macOS. Questi comandi iniziano con dotnet ef.

• Gli strumenti della console di Gestione pacchetti (PMC) vengono eseguiti in Visual Studio in Windows. Questi comandi iniziano con un verbo, ad esempio Add-Migration, Update-Database.

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

Gli strumenti dell'interfaccia della riga di comando di .NET richiedono .NET SDK, indicati in precedenza in 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
  

Important

Usare sempre la versione del pacchetto degli strumenti corrispondente 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 Microsoft.EntityFrameworkCore.Tools pacchetto. Ad esempio, da 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. È sufficiente eseguire l'aggiornamento alla nuova versione del provider per ottenere tutti i miglioramenti.

• Se è necessario aggiornare un'applicazione che usa un provider di database di terze parti, verificare sempre la presenza di un aggiornamento del provider compatibile con la versione di EF 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 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.