Instalación de Entity Framework Core

  • Artículo

Requisitos previos

  • EF requiere el SDK de .NET más reciente.

    • En runtime, EF Core requiere una versión reciente de .NET. Consulte Versiones de EF Core para encontrar la versión mínima de .NET necesaria para la versión de EF Core que quiere usar.

  • Puede usar EF Core para desarrollar aplicaciones en Windows con Visual Studio. Se recomienda usar la última versión de Visual Studio.

Obtener Entity Framework Core

EF Core se distribuye como paquetes NuGet. Para agregar EF Core a una aplicación, instale el paquete NuGet para el proveedor de bases de datos que quiera usar. Consulte Proveedores para obtener una lista de los proveedores de bases de datos disponibles.

Para instalar o actualizar paquetes NuGet, puede usar la interfaz de la línea de comandos (CLI) de .NET Core, o bien el cuadro de diálogo o la consola del Administrador de paquetes de Visual Studio.

CLI de .NET Core

  • Use el comando de la CLI de .NET Core en la línea de comandos del sistema operativo para instalar o actualizar el proveedor de SQL Server de EF Core:

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer

  • Puede indicar una versión específica en el comando dotnet add package usando el modificador -v. Por ejemplo, para instalar paquetes de EF Core 6.0.14, anexe -v 6.0.14 al comando.

Para obtener más información, vea Herramientas de la interfaz de la línea de comandos (CLI) de .NET Core.

Cuadro de diálogo Administrador de paquetes NuGet en Visual Studio

  • En el menú de Visual Studio, seleccione Proyecto > Administrar paquetes NuGet

  • Haga clic en la pestaña Examinar o Actualizaciones

  • Para instalar o actualizar el proveedor de SQL Server, seleccione el paquete Microsoft.EntityFrameworkCore.SqlServer y confirme la acción.

Para obtener más información, vea Diálogo del Administrador de paquetes NuGet.

Consola del Administrador de paquetes NuGet de Visual Studio

  • En el menú de Visual Studio, seleccione Herramientas > Administrador de paquetes NuGet > Consola del Administrador de paquetes

  • Para instalar el proveedor de SQL Server, ejecute el comando siguiente en la consola del Administrador de paquetes:

    Install-Package Microsoft.EntityFrameworkCore.SqlServer

  • Para actualizar el proveedor, use el comando Update-Package.

  • Para especificar una versión, use el modificador -Version. Por ejemplo, para instalar paquetes de EF Core 6.0.14, anexe -Version 6.0.14 a los comandos.

Para obtener más información, vea Consola del Administrador de paquetes.

Obtención de las herramientas de Entity Framework Core

Puede instalar herramientas para llevar a cabo tareas relacionadas con EF Core en el proyecto, como crear y aplicar las migraciones de bases de datos o crear un modelo de EF Core basado en una base de datos existente.

Existen dos conjuntos de herramientas:

Obtención de las herramientas de la CLI de .NET Core

Las herramientas de la CLI de .NET Core requieren el SDK de .NET Core, tal como se indica en Requisitos previos.

  • dotnet ef debe estar instalado como herramienta global o local. La mayoría de los desarrolladores prefieren instalar dotnet ef como herramienta global con el siguiente comando:

    dotnet tool install --global dotnet-ef

    dotnet ef también se puede usar como herramienta local. Para usarlo como herramienta local, restaure las dependencias de un proyecto que lo declare como dependencia de herramientas mediante un archivo de manifiesto de herramientas.

  • Para actualizar las herramientas, use el comando dotnet tool update.

  • Instale la versión más reciente del paquete Microsoft.EntityFrameworkCore.Design.

    dotnet add package Microsoft.EntityFrameworkCore.Design

Importante

Use siempre la versión del paquete de herramientas que coincida con la versión principal de los paquetes en tiempo de ejecución.

Obtención de las herramientas de la consola del Administrador de paquetes

Para obtener las herramientas de la consola del Administrador de paquetes para EF Core, instale el paquete Microsoft.EntityFrameworkCore.Tools. Por ejemplo, en Visual Studio:

Install-Package Microsoft.EntityFrameworkCore.Tools

Actualización a la versión más reciente de EF Core

  • Cuando publicamos una nueva versión de EF Core, también publicamos una nueva versión de los proveedores que forman parte del proyecto de EF Core, como, por ejemplo: Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos y Microsoft.EntityFrameworkCore.InMemory. Para obtener todas las mejoras, solo tiene que actualizar a la nueva versión del proveedor.

  • Si necesita actualizar una aplicación que usa un proveedor de base de datos de terceros, busque siempre una actualización del proveedor que sea compatible con la versión de EF Core que quiere usar. Por ejemplo, los proveedores de bases de datos de la versión 1.0 no son compatibles con la versión 2.0 del entorno de ejecución de EF Core, y así sucesivamente.

  • Los proveedores de terceros de EF Core no suelen publicar versiones de revisión junto al runtime de EF Core. Para actualizar una aplicación que use un proveedor de terceros a una versión de revisión de EF Core, puede que deba agregar una referencia directa a determinados componentes de runtime de EF Core, en especial Microsoft.EntityFrameworkCore y Microsoft.EntityFrameworkCore.Relational.