Installazione di Entity Framework Core
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:
Gli strumenti dell'interfaccia della riga di comando (CLI) di .NET Core possono essere usati in Windows, Linux o macOS. Questi comandi iniziano con
dotnet ef
.Gli strumenti della console di Gestione pacchetti vengono eseguiti in Visual Studio su Windows. Questi comandi iniziano con un verbo, ad esempio
Add-Migration
,Update-Database
.
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'installazionedotnet 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.