Язык программирования C#9 и платформа .NET5 - Троелсен Эндрю
Создание класса, производного от 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:
(window.adrunTag = window.adrunTag || []).push({v: 1, el: 'adrun-4-390', c: 4, b: 390})using System;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;
namespace AutoLot.Samples
{
public class ApplicationDbContextFactory : IDesignTimeDbContextFactory
<ApplicationDbContext>
{
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:
