Создание класса, производного от DbContext
Первый шаг в EF Core заключается в создании специального класса, унаследованного от
DbContext
. Затем добавляется конструктор, который принимает строго типизированный экземпляр
DbContextOptions
(рассматривается далее) и передает его конструктору базового класса:
namespace AutoLot.Samples
{
public class ApplicationDbContext : DbContext
{
public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
: base(options)
{
}
}
}
Именно производный от
DbContext
класс применяется для доступа к базе данных и работает с сущностями, средством отслеживания изменений и всеми компонентами EF Core.
Конфигурирование экземпляра DbContext
Экземпляр
DbContext
конфигурируется с использованием экземпляра класса
DbContextOptions
. Экземпляр
DbContextOptions
создается с применением
DbContextOptionsBuilder
, т.к. класс
DbContextOptions
не рассчитан на создание экземпляров непосредственно в коде. Через экземпляр
DbContextOptionsBuilder
выбирается поставщик базы данных (наряду с любыми настройками, касающимися поставщика) и устанавливаются общие параметры экземпляра
DbContext
инфраструктуры EF Core (наподобие ведения журнала). Затем свойство
Options
внедряется в базовый класс
DbContext
во время выполнения.
Такая возможность динамического конфигурирования позволяет изменять настройки во время выполнения, просто выбирая разные параметры (скажем, поставщик MySQL вместо SQL Server) и создавая новый экземпляр производного класса
DbContext
.
Фабрика DbContext этапа проектирования
Фабрика
DbContext
этапа проектирования представляет собой класс, который реализует интерфейс
IDesignTimeDbContextFactory<T>
, где
Т
— класс, производный от
DbContext
. Интерфейс
IDesignTimeDbContextFactory<T>
имеет один метод
CreateDbContext()
, который должен быть реализован для создания экземпляра производного класса
DbContext
.
В показанном ниже классе
ApplicationDbContextFactory
с помощью метода
CreateDbContext()
создается строго типизированный экземпляр
DbContextOptionsBuilder
для класса
ApplicationDbContext
, устанавливается поставщик баз данных SQL Server (с использованием строки подключения к экземпляру Docker из главы 21), после чего создается и возвращается новый экземпляр
ApplicationDbContext
:
using System;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;
namespace AutoLot.Samples
{
public class ApplicationDbContextFactory : IDesignTimeDbContextFactory
<ApplicationDb
Context>
{
public ApplicationDbContext CreateDbContext(string[] args)
{
var optionsBuilder = new DbContextOptionsBuilder<ApplicationDbContext>();
var connectionString =
@"server=.,5433;Database=AutoLotSamples;
User Id=sa;Password=
P@ssw0rd;";
optionsBuilder.UseSqlServer(connectionString);
Console.WriteLine(connectionString);
return new ApplicationDbContext(optionsBuilder.Options);
}
}
}
Интерфейс командной строки задействует фабрику контекстов, чтобы создать экземпляр производного класса
DbContext
, предназначенный для выполнения действий вроде создания и применения миграций базы данных. Поскольку фабрика является конструкцией этапа проектирования и не используется во время выполнения, строка подключения к базе данных разработки обычно будет жестко закодированной. В версии EF Core 5 появилась возможность передавать методу
CreateDbContext()
аргументы из командной строки, о чем пойдет речь позже в главе.
Метод OnModelCreating()
Базовый класс
DbContext
открывает доступ к методу
OnModelCreating()
, который применяется для придания формы сущностям, используя Fluent API. Детали подробно раскрываются далее в главе, а пока добавьте в класс
ApplicationDbContext
следующий код:
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
// Обращения к Fluent API.
OnModelCreatingPartial(modelBuilder);
}
partial void OnModelCreatingPartial(ModelBuilder modelBuilder);
Сохранение изменений
Чтобы заставить
DbContext
и
ChangeTracker
сохранить любые изменения, внесенные в отслеживаемые сущности, вызовите метод
SaveChanges()
(или
SaveChangesAsync()
) на экземпляре класса, производного от
DbContext
:
