Класс
DbSet<T>
реализует интерфейс
IQueryable<T>
и обычно является целью запросов LINQ to Entity. Помимо расширяющих методов, добавленных инфраструктурой EF Core, класс
DbSet<T>
поддерживает расширяющие методы, которые вы изучили в главе 13, такие как
ForEach()
,
Select()
и
All()
.
Вы узнаете, как добавлять к классу
ApplicationDbContext
свойства типа
DbSet<T>
, в разделе "Сущности" далее в главе.
На заметку! Многие методы из перечисленных в табл. 22.2, имеют те же самые имена, что и методы в табл. 22.1. Основное отличие в том, что методам
DbSet<T>
уже известен тип, с которым нужно работать, и список сущностей. Методы
DbContext
обязаны определять, на чем действовать, с применением рефлексии. Методы
DbSet<T>
используются гораздо чаще, чем методы
DbContext
.
Типы запросов
Типы запросов — это коллекции
DbSet<T>
, которые применяются для изображения представлений, оператора SQL или таблиц без первичного ключа. В предшествующих версиях EF Core для всего упомянутого использовался тип
DbQuery<T>
, но начиная с EF Core 3.1, тип
DbQuery
больше не употребляется. Типы запросов добавляются к производному классу
DbContext
с применением свойств
DbSet<T>
и конфигурируются как не имеющие ключей.
Например, класс
CustomerOrderViewModel
(который вы создадите при построении полной библиотеки доступа к данным
AutoLot
) конфигурируется с атрибутом
[Keyless]
:
<b>[Keyless]</b>
public class CustomerOrderViewModel
{
...
}
Остальные действия по конфигурированию делаются в Fluent API. В следующем примере сущность устанавливается как не имеющая ключа, а тип запроса сопоставляется с представлением базы данных
dbo.CustomerOrderView
(обратите внимание, что вызов метод
HasNoKey()
из Fluent API не требуется, если в модели присутствует аннотация данных
Keyless
, и наоборот, но он показан ради полноты):
modelBuilder.Entity<CustomerOrderViewModel>().HasNoKey().ToView("CustomerOrderView", "dbo");
Типы запросов могут также сопоставляться с запросом SQL, как показано ниже:
modelBuilder.Entity<CustomerOrderViewModel>().HasNoKey().ToSqlQuery(
@"SELECT c.FirstName, c.LastName, i.Color, i.PetName, m.Name AS Make
FROM dbo.Orders o
INNER JOIN dbo.Customers c ON o.CustomerId = c.Id
INNER JOIN dbo.Inventory i ON o.CarId = i.Id
INNER JOIN dbo.Makes m ON m.Id = i.MakeId");
Последние механизмы, с которыми можно использовать типы запросов — это методы
FromSqlRaw()
и
FromSqlInterpolated()
. Вот пример того же самого запроса, но с применением
FromSqlRaw()
:
public IEnumerable<CustomerOrderViewModel> GetOrders()
{
return CustomerOrderViewModels.FromSqlRaw(
@"SELECT c.FirstName, c.LastName, i.Color, i.PetName, m.Name AS Make
FROM dbo.Orders o
INNER JOIN dbo.Customers c ON o.CustomerId = c.Id
INNER JOIN dbo.Inventory i ON o.CarId = i.Id
INNER JOIN dbo.Makes m ON m.Id = i.MakeId");
}
Гибкое сопоставление с запросом или таблицей
В версии EF Core 5 появилась возможность сопоставления одного и того же класса с более чем одним объектом базы данных. Такими объектами могут быть таблицы, представления или функции. Например, класс
CarViewModel
из главы 21 может отображаться на представление, которое возвращает название производителя с данными
Car
и таблицей Inventory. Затем EF Core будет запрашивать из представления и отправлять обновления таблице:
modelBuilder.Entity<CarViewModel>()
.ToTable("Inventory")
.ToView("InventoryWithMakesView");
Экземпляр ChangeTracker
Экземпляр
ChangeTracker
отслеживает состояние объектов, загруженных в
DbSet<T>
внутри экземпляра
DbContext
. В табл. 22.3 описаны возможные значения для состояния объекта.
Для проверки состояния объекта используйте следующий код:
EntityState state = context.Entry(entity).State;
Вы также можете программно изменять состояние объекта с применением того же самого механизма. Чтобы изменить состояние на
Deleted
, используйте такой код:
context.Entry(entity).State = EntityState.Deleted;
События ChangeTracker
Экземпляр
ChangeTracker
способен генерировать два события:
StateChanged
и
Tracked
. Событие
StateChanged
инициируется в случае изменения состояния сущности. Оно не генерируется при отслеживании сущности в первый раз. Событие
Tracked
инициируется, когда сущность начинает отслеживаться, либо за счет добавления экземпляра
DbSet<T>
в коде, либо при возвращении из запроса.