Установка Entity Framework Core

  • Статья

Необходимые компоненты

  • ДЛЯ EF требуется последний пакет SDK для .NET.

    • Во время выполнения EF Core требуется последняя версия .NET. Ознакомьтесь с выпусками EF Core, чтобы найти минимальную версию .NET, необходимую для использования версии EF Core.

  • EF Core можно использовать для разработки приложений в Windows с использованием Visual Studio. Рекомендуется использовать последнюю версию Visual Studio.

Получение Entity Framework Core

EF Core поставляется как пакеты NuGet. Чтобы добавить EF Core в приложение, установите пакет NuGet для поставщика базы данных, который вы хотите использовать. Список доступных поставщиков баз данных см. в разделе "Поставщики баз данных".

Установить или обновить пакеты NuGet можно в интерфейсе командной строки (CLI) .NET Core, а также в диалоговом окне или консоли диспетчера пакетов Visual Studio.

Интерфейс командной строки .NET Core

  • Чтобы установить или обновить поставщик EF Core SQL Server, выполните следующую команду интерфейса командной строки .NET Core в командной строке операционной системы:

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer

  • Вы можете указать в команде dotnet add package конкретную версию, используя модификатор -v. Например, чтобы установить пакеты EF Core 6.0.14, добавьте -v 6.0.14 в команду.

Дополнительные сведения см. в разделе Средства интерфейса командной строки (CLI) .NET.

Диалоговое окно диспетчера пакетов NuGet в Visual Studio

  • В меню Visual Studio выберите "Проект" > "Управление пакетами NuGet"

  • Нажмите кнопку Обзор или откройте вкладку Обновления.

  • Чтобы установить или обновить поставщик SQL Server, выберите пакет Microsoft.EntityFrameworkCore.SqlServer и подтвердите свой выбор.

Дополнительные сведения: Диалоговое окно диспетчера пакетов NuGet.

Консоль диспетчера пакетов NuGet в Visual Studio

  • В меню Visual Studio выберите "Сервис" > "Диспетчер пакетов NuGet" > "Консоль диспетчера пакетов"

  • Чтобы установить поставщик SQL Server, в консоли диспетчера пакетов выполните следующую команду:

    Install-Package Microsoft.EntityFrameworkCore.SqlServer

  • Чтобы обновить поставщик, используйте команду Update-Package.

  • Чтобы указать конкретную версию, используйте модификатор -Version. Например, чтобы установить пакеты EF Core 6.0.14, добавьте -Version 6.0.14 к командам

Дополнительные сведения: Консоль диспетчера пакетов.

Получение инструментов Entity Framework Core

Вы можете установить инструменты для выполнения задач, связанных с EF Core, в своем проекте, таких как создание и применение миграций базы данных, а также создание модели EF Core на основе существующей базы данных.

Доступно два набора инструментов:

Получение инструментов CLI для .NET Core

Для инструментов CLI .NET Core требуется пакет SDK для .NET Core, указанный ранее в разделе Необходимые компоненты.

  • Средство dotnet ef должно быть установлено в качестве глобального или локального средства. Большинство разработчиков предпочитают устанавливать средство dotnet ef в качестве глобального средства, используя следующую команду:

    dotnet tool install --global dotnet-ef

    Средство dotnet ef также может использоваться в качестве локального средства. Чтобы использовать его в качестве локального средства, восстановите зависимости проекта, в котором оно объявляется в качестве соответствующей зависимости, с помощью файла манифеста средства.

  • Чтобы обновить средства, используйте команду dotnet tool update.

  • Установите последнюю версию пакета Microsoft.EntityFrameworkCore.Design.

    dotnet add package Microsoft.EntityFrameworkCore.Design

Важно!

Всегда используйте версии пакетов инструментов, которые соответствуют основному номеру версии для пакетов среды выполнения.

Получение инструментов консоли диспетчера пакетов

Чтобы получить инструменты консоли диспетчера пакетов для EF Core, установите пакет Microsoft.EntityFrameworkCore.Tools. Например, в Visual Studio:

Install-Package Microsoft.EntityFrameworkCore.Tools

Обновление до последней версии EF Core

  • Каждый раз, когда мы выпускаем новую версию EF Core, мы также выпускаем новую версию поставщиков, которые являются частью проекта EF Core, например Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos и Microsoft.EntityFrameworkCore.InMemory. Кроме того, можно просто обновить поставщик до новой версии, чтобы получить все улучшения.

  • Если требуется обновить приложение, использующее сторонний поставщик базы данных, всегда ищите обновление поставщика, совместимое с нужной вам версией EF Core. Например, поставщики баз данных для версии 1.0 несовместимы с версией 2.0 среды выполнения EF Core и т. д.

  • Сторонние поставщики EF Core обычно не выпускают исправления вместе со средой выполнения EF Core. Чтобы обновить приложение, которое использует стороннего поставщика до версии исправления EF Core, может потребоваться добавить прямую ссылку на отдельные компоненты среды выполнения EF Core, в частности Microsoft.EntityFrameworkCore и Microsoft.EntityFrameworkCore.Relational.