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

class="p1">Вспомните, что метод SaveChanges() выполняется в неявной транзакции, если только не применяется явная транзакция. Если сохранение было успешным, то затем запрашиваются значения, сгенерированные сервером, для установки значений в сущностях. Все эти тесты будут использовать явную транзакцию, так что можно производить откат, оставив базу данных в том же состоянии, в каком она находилась, когда начинался прогон тестов.

Все операторы SQL, показанные далее в разделе, были получены с применением профилировщика SQL Server.

На заметку! Записи можно добавлять также с использованием класса, производного от DbContext. Во всех примерах для добавления записей будут применяться свойства DbSet<T>. В классах DbSet<T> и DbContext имеются асинхронные версии методов Add()/AddRange(), но здесь рассматриваются только синхронные версии.

Состояние сущности

Когда сущность создана с помощью кода, но еще не была добавлена в DbSet<T>, значением EntityState является Detached. После добавления новой сущности в DbSet<T> значение EntityState устанавливается в Added. В случае успешного выполнения SaveChanges() значение EntityState устанавливается в Unchanged.

Добавление одной записи

В следующем тесте демонстрируется добавление одиночной записи в таблицу Inventory:

[Fact]

public void ShouldAddACar()

{

  ExecuteInATransaction(RunTheTest);

  void RunTheTest()

  {

    var car = new Car

    {

      Color = "Yellow",

      MakeId = 1,

      PetName = "Herbie"

    };

    var carCount = Context.Cars.Count();

    Context.Cars.Add(car);

    Context.SaveChanges();

    var newCarCount = Context.Cars.Count();

    Assert.Equal(carCount+1,newCarCount);

  }

}

Ниже приведен выполняемый оператор SQL. Обратите внимание, что у недавно добавленной сущности запрашиваются свойства, сгенерированные базой данных (Id и TimeStamp). Когда результат запроса поступает в исполняющую среду EF Core, сущность обновляется с использованием значений серверной стороны:

exec sp_executesql N'SET NOCOUNT ON;

INSERT INTO [dbo].[Inventory] ([Color], [MakeId], [PetName])

VALUES (@p0, @p1, @p2);

SELECT [Id], [IsDrivable], [TimeStamp]

FROM [dbo].[Inventory]

WHERE @@ROWCOUNT = 1 AND [Id] = scope_identity();

',N'@p0 nvarchar(50),@p1 int,@p2 nvarchar(50)',@p0=N'Yellow',@p1=1,@p2=N'Herbie'

Добавление одной записи с использованием метода Attach()

Когда первичный ключ сущности сопоставлен со столбцом идентичности в SQL Server, исполняющая среда EF Core будет трактовать экземпляр сущности как добавленный (Added), если значение свойства первичного ключа равно 0. Следующий тест создает новую сущность Car и оставляет для свойства Id стандартное значение 0. После присоединения сущности к ChangeTracker ее состояние устанавливается в Added и вызов SaveChanges() добавит сущность в базу данных:

[Fact]

public void ShouldAddACarWithAttach()

{

  ExecuteInATransaction(RunTheTest);

  void RunTheTest()

  {

    var car = new Car

    {

      Color = "Yellow",

      MakeId = 1,

      PetName = "Herbie"

    };

    var carCount = Context.Cars.Count();

    Context.Cars.Attach(car);

    Assert.Equal(EntityState.Added, Context.Entry(car).State);

    Context.SaveChanges();

    var newCarCount = Context.Cars.Count();

    Assert.Equal(carCount + 1, newCarCount);

  }

}

Добавление нескольких записей одновременно

Чтобы вставить в одной транзакции сразу несколько записей, применяйте метод AddRange() класса DbSet<T>, как показано в приведенном далее тесте (обратите внимание, что для активизации пакетирования при сохранении данных в SQL Server должно быть инициировано не менее четырех действий):

[Fact]

public void ShouldAddMultipleCars()

{

  ExecuteInATransaction(RunTheTest);

  void RunTheTest()

  {

    // Для активизации пакетирования должны быть добавлены четыре сущности

    var cars = new List<Car>

    {

      new() { Color = "Yellow", MakeId = 1, PetName = "Herbie" },

      new() { Color = "White", MakeId = 2, PetName = "Mach 5" },

      new() { Color = "Pink", MakeId = 3, PetName = "Avon" },

      new() { Color = "Blue", MakeId = 4, PetName = "Blueberry" },

    };

 var carCount = Context.Cars.Count();

    Context.Cars.AddRange(cars);

    Context.SaveChanges();

    var newCarCount = Context.Cars.Count();

    Assert.Equal(carCount + 4, newCarCount);

  }

}

Операторы добавления пакетируются в единственное обращение к базе данных и запрашиваются все сгенерированные столбцы. Когда результаты запроса поступают в EF Core, сущности обновляются с использованием значений серверной стороны. Вот как выглядит выполняемый оператор SQL:

exec sp_executesql N'SET NOCOUNT ON;

DECLARE @inserted0 TABLE ([Id] int, [_Position] [int]);

MERGE [dbo].[Inventory] USING (

VALUES (@p0, @p1, @p2, 0),

(@p3, @p4, @p5, 1),

(@p6, @p7, @p8, 2),

(@p9, @p10, @p11, 3)) AS i ([Color], [MakeId], [PetName], _Position) ON 1=0

WHEN NOT MATCHED THEN

INSERT ([Color], [MakeId], [PetName])

VALUES (i.[Color], i.[MakeId], i.[PetName])

OUTPUT INSERTED.[Id], i._Position

INTO @inserted0;

SELECT [t].[Id], [t].[IsDrivable], [t].[TimeStamp] FROM [dbo].[Inventory] t

INNER JOIN @inserted0 i ON ([t].[Id] = [i].[Id])

ORDER BY [i].[_Position];',

N'@p0 nvarchar(50),@p1 int,@p2 nvarchar(50),@p3 nvarchar(50),

@p4 int,@p5 nvarchar(50), @p6 nvarchar(50),@p7 int,@p8 nvarchar(50),

@p9 nvarchar(50),@p10 int,@p11 nvarchar(50)', @p0=N'Yellow',@p1=1,

@p2=N'Herbie',@p3=N'White',@p4=2,@p5=N'Mach 5',@p6=N'Pink',@p7=3,

@p8=N'Avon',@p9=N'Blue',@p10=4,@p11=N'Blueberry'

Соображения относительно столбца идентичности при добавлении записей

Когда сущность имеет числовое свойство, которое определено как первичный ключ, то такое свойство (по умолчанию) отображается на столбец идентичности (Identity) в SQL Server. Исполняющая среда EF Core считает сущность со стандартным (нулевым) значением для свойства ключа новой, а сущность с нестандартным значением — уже присутствующей в базе данных. Если вы создаете новую сущность и устанавливаете свойство первичного ключа в ненулевое число, после чего пытаетесь добавить ее в базу данных, то EF Core откажется добавлять запись, поскольку вставка идентичности не разрешена. Включение вставки идентичности демонстрируется в коде инициализации данных.

Добавление объектного графа

При добавлении сущности в базу данных дочерние записи могут быть добавлены в том же самом обращении без их специального добавления в собственный экземпляр DbSet<T>, если они добавлены в свойство типа коллекции для родительской записи. Например, пусть создается новая сущность Make и в ее свойство Cars добавляется дочерняя запись Car. Когда сущность Make