Перенос модели на основе кода EF6 в EF Core

Статья
11/14/2024

Если вы прочитали все предостережения и готовы к переносу, приведенные ниже рекомендации помогут вам начать.

Установка пакетов NuGet EF Core

Чтобы использовать EF Core, установите пакет NuGet для нужного поставщика базы данных. Например, при ориентации на SQL Server нужно установить Microsoft.EntityFrameworkCore.SqlServer. Дополнительные сведения см. в разделе Поставщики баз данных.

Если планируется использовать миграции, следует также установить пакет Microsoft.EntityFrameworkCore.Tools.

Можно оставить установленный пакет NuGet EF6 (EntityFramework), так как EF Core и EF6 могут использоваться параллельно в одном приложении. Однако если вы не планируете использовать EF6 в каких-либо областях приложения, то удаление пакета поможет вывести ошибки компиляции для фрагментов кода, требующих внимания.

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

Большинство API, используемых в EF6, находятся в пространстве имен System.Data.Entity (и связанных подпространствах имен). Первое изменение кода заключается в переключении на пространство имен Microsoft.EntityFrameworkCore. В общем случае вам следует начать с производного файла кода контекста, а затем действовать из него, устраняя ошибки компиляции по мере их возникновения.

Конфигурация контекста (подключение и т. п.)

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

Большинство приложений EF6 хранят строку подключения в файле App/Web.config приложения. В EF Core для считывания этой строки подключения используется API ConfigurationManager. Чтобы использовать этот API, может потребоваться добавить ссылку System.Configuration на сборку платформы:

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
      optionsBuilder.UseSqlServer(ConfigurationManager.ConnectionStrings["BloggingDatabase"].ConnectionString);
    }
}

Предупреждение никогда не хранит пароли или другие конфиденциальные данные в исходном коде или файлах конфигурации. Не следует использовать секреты рабочей среды для разработки или тестирования. Секреты не следует развертывать с приложением. Доступ к рабочим секретам должен осуществляться с помощью контролируемых средств, таких как Azure Key Vault. Тестовые и рабочие секреты Azure могут храниться и защищаться с помощью поставщика конфигурации Azure Key Vault.

Обновление кода

На этом этапе осуществляется устранение ошибок компиляции и проверка кода, чтобы узнать, затронут ли вас изменения поведения.

Существующие миграции

Фактически не существует практичного способа перенести имеющиеся миграции EF6 в EF Core.

По возможности лучше всего предположить, что все предыдущие миграции из EF6 были применены к базе данных, а затем начать миграцию схемы с этой точки с помощью EF Core. Для этого используйте команду Add-Migration, чтобы добавить миграцию после переноса модели в EF Core. Затем следует удалить весь код из методов Up и Down шаблонной миграции. Последующие миграции будут сравниваться с моделью после создания шаблона первоначальной миграции.

Тестирование переноса

Даже если приложение компилируется, это не означает, что оно успешно перенесено в EF Core. Необходимо протестировать все области приложения, чтобы предотвратить отсутствие неблагоприятного воздействия каких-либо изменений поведения.

Наконец, ознакомьтесь с подробными примерами, которые следует учитывать при переносе.

Поделиться через