Язык программирования C#9 и платформа .NET5

Класс 
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&lt;CustomerOrderViewModel&gt;().HasNoKey().ToView(&quot;CustomerOrderView&quot;, &quot;dbo&quot;);
Типы запросов могут также сопоставляться с запросом SQL, как показано ниже: 
modelBuilder.Entity&lt;CustomerOrderViewModel&gt;().HasNoKey().ToSqlQuery(
 
  @&quot;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&quot;);
Последние механизмы, с которыми можно использовать типы запросов — это методы 
FromSqlRaw()
 и 
FromSqlInterpolated()
. Вот пример того же самого запроса, но с применением 
FromSqlRaw()
:
public IEnumerable&lt;CustomerOrderViewModel&gt; GetOrders()
{
  return CustomerOrderViewModels.FromSqlRaw(
    @&quot;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&quot;);
}
  
Гибкое сопоставление с запросом или таблицей
 
В версии EF Core 5 появилась возможность сопоставления одного и того же класса с более чем одним объектом базы данных. Такими объектами могут быть таблицы, представления или функции. Например, класс 
CarViewModel
 из главы 21 может отображаться на представление, которое возвращает название производителя с данными 
Car
 и таблицей Inventory. Затем EF Core будет запрашивать из представления и отправлять обновления таблице:
modelBuilder.Entity&lt;CarViewModel&gt;()
  .ToTable(&quot;Inventory&quot;)
  .ToView(&quot;InventoryWithMakesView&quot;);
  
Экземпляр ChangeTracker
 
Экземпляр 
ChangeTracker
 отслеживает состояние объектов, загруженных в 
DbSet&lt;T&gt;
 внутри экземпляра 
DbContext
. В табл. 22.3 описаны возможные значения для состояния объекта.
Для проверки состояния объекта используйте следующий код:
EntityState state = context.Entry(entity).State;
Вы также можете программно изменять состояние объекта с применением того же самого механизма. Чтобы изменить состояние на 
Deleted
, используйте такой код:
context.Entry(entity).State = EntityState.Deleted;
  
События ChangeTracker
 
Экземпляр 
ChangeTracker
 способен генерировать два события: 
StateChanged
 и 
Tracked
. Событие 
StateChanged
 инициируется в случае изменения состояния сущности. Оно не генерируется при отслеживании сущности в первый раз. Событие 
Tracked
 инициируется, когда сущность начинает отслеживаться, либо за счет добавления экземпляра 
DbSet&lt;T&gt;
 в коде, либо при возвращении из запроса.