Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен

  try

   {

    actionToExecute();

    trans.Commit();

  }

  catch (Exception ex)

  {

    trans.Rollback();

  }

});

События SavingChanges/SavedChanges

В версии EF Core 5 появились три новых события, которые инициируются методами SaveChanges()/SaveChangesAsync(). Событие SavingChanges запускается при вызове SaveChanges(), но перед выполнением операторов SQL в хранилище данных, а событие SavedChanges — после завершения работы метода SaveChanges(). В следующем (простейшем) коде демонстрируются события и их обработчики в действии:

public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)

    : base(options)

{

  SavingChanges += (sender, args) =>

  {

     Console.WriteLine($"Saving changes for {((DbContext)sender).Database.

GetConnectionString()}");

  };

  SavedChanges += (sender, args) =>

  {

    Console.WriteLine($"Saved {args.EntitiesSavedCount} entities");

  };

  SaveChangesFailed += (sender, args) =>

  {

    Console.WriteLine($"An exception occurred! {args.Exception.Message}

entities");

  };

}

Класс DbSet<T>

Для каждой сущности в своей объектной модели вы добавляете свойство типа DbSet<T>. Класс DbSet<T> представляет собой специализированную коллекцию, используемую для взаимодействия с поставщиком баз данных с целью получения, добавления, обновления и удаления записей в базе данных. Каждая коллекция DbSet<T> предлагает несколько основных служб для взаимодействия с базой данных. Любые запросы LINQ, запускаемые в отношении класса DbSet<T>, транслируются поставщиком базы данных в запросы к базе данных. В табл. 22.2 описан ряд основных членов класса DbSet<T>.

Класс 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]:

[Keyless]

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> в коде, либо при возвращении из запроса.

Сброс состояния DbContext

В версии EF Core 5 появилась возможность сброса состояния DbContext. Метод ChangeTracker.Clear() отсоединяет все сущности от свойств DbSet<T>, устанавливая их состояние в Detached.

Сущности

Строго типизированные классы, которые сопоставляются с таблицами базы данных, официально именуются сущностями. Коллекция сущностей в приложении образует концептуальную модель физической базы данных. Выражаясь формально, такая модель называется моделью сущностных данных (entity data model — EDM) или просто моделью. Модель сопоставляется с предметной областью приложения.