Entity Framework Core系列教程-17-断开模式下更新数据
Entity Framework Core 断开连接场景中更新数据
EF Core API会为EntityState已修改的实体在数据库中生成并执行UPDATE语句。在连接的场景中，DbContext会跟踪所有实体，因此它知道哪些实体被修改，因此会自动将EntityState设置为Modified。
在断开连接的情况下（例如，在Web应用程序中），DbContext不知道实体，因为修改的实体超出了当前DbContext实例的范围。因此，首先我们需要将断开连接的实体附加到具有修改后的EntityState的DbContext实例。
下表列出了用于更新实体的DbContext和DbSet方法：
| DbContext方法 | DbSet方法 | 描述 |
|---|---|---|
| DbContext.Update | DbSet.Update | DbSet.Update将实体附加到具有修改状态的DbContext |
| DbContext.UpdateRange | DbSet.UpdateRange | DbSet.UpdateRange将实体集合附加到具有修改状态的DbContext |
下面的示例演示如何更新断开连接的实体。
// 断开连接的学生实体
var stud = new Student(){ StudentId = 1, Name = "Bill" };
stud.Name = "Steve";
using (var context = new SchoolContext())
{
context.Update<Student>(stud);
// 或以下内容也有效
// context.Students.Update(stud);
// context.Attach<Student>(stud).State = EntityState.Modified;
// context.Entry<Student>(stud).State = EntityState.Modified;
context.SaveChanges();
}
在上面的示例中，将stu视为现有的Student实体对象，因为它具有有效的Key属性值（StudentId = 1）。Entity Framework Core引入了DbContext.Update()方法，该方法将指定的实体附加到上下文，并将其EntityState设置为Modified。或者，您也可以使用DbSet.Update()方法（context.Students.Update（stud））执行相同的操作。
上面的示例在数据库中执行以下UPDATE语句。
exec sp_executesql N'SET NOCOUNT ON;
UPDATE [Students] SET [Name] = @p0
WHERE [StudentId] = @p1;
SELECT @@ROWCOUNT;
',N'@p1 int,@p0 nvarchar(4000)',@p1=1,@p0=N'Steve'
go
更新多个实体
使用DbContext.UpdateRange或DbSet.UpdateRange方法将实体的集合或实体数组附加到DbContext，并一次性将其EntityState设置为Modified。
var modifiedStudent1 = new Student()
{
StudentId = 1,
Name = "Bill"
};
var modifiedStudent2 = new Student()
{
StudentId = 3,
Name = "Steve"
};
var modifiedStudent3 = new Student()
{
StudentId = 3,
Name = "James"
};
IList<Student> modifiedStudents = new List<Student>()
{
modifiedStudent1,
modifiedStudent2,
modifiedStudent3
};
using (var context = new SchoolContext())
{
context.UpdateRange(modifiedStudents);
// 或以下内容也有效
//context.UpdateRange(modifiedStudent1, modifiedStudent2, modifiedStudent3);
//context.Students.UpdateRange(modifiedStudents);
//context.Students.UpdateRange(modifiedStudent1, modifiedStudent2, modifiedStudent3);
context.SaveChanges();
}
如您所见，UpdateRange方法有两个重载。一个重载采用实体的集合，第二个重载采用object []作为参数。 DbSet.UpdateRange方法的工作方式与DbContext.UpdateRange方法相同。
EF Core通过为以上示例中的所有实体构建UPDATE语句并在一次数据库往返中执行该语句来提高性能。
exec sp_executesql N'SET NOCOUNT ON;
UPDATE [Students] SET [Name] = @p0
WHERE [StudentId] = @p1;
SELECT @@ROWCOUNT;
UPDATE [Students] SET [Name] = @p2
WHERE [StudentId] = @p3;
SELECT @@ROWCOUNT;
UPDATE [Students] SET [Name] = @p4
WHERE [StudentId] = @p5;
SELECT @@ROWCOUNT;
',N'@p1 int,@p0 nvarchar(4000),@p3 int,@p2 nvarchar(4000),@p5 int,@p4 nvarchar(4000)',
@p1=1,@p0=N'Bill',@p3=2,@p2=N'Steve',@p5=3,@p4=N'James'
go
EntityState中的更改
Update方法根据键属性的值设置EntityState。如果根或子实体的key属性为空，指定数据类型的null或默认值，则Update（）方法将其视为新实体，并将其EntityState设置为Entity Framework Core 2.x中的Added。
public static void Main()
{
var newStudent = new Student()
{
Name = "Bill"
};
var modifiedStudent = new Student()
{
StudentId = 1,
Name = "Steve"
};
using (var context = new SchoolContext())
{
context.Update<Student>(newStudent);
context.Update<Student>(modifiedStudent);
DisplayStates(context.ChangeTracker.Entries());
}
}
private static void DisplayStates(IEnumerable<EntityEntry> entries)
{
foreach (var entry in entries)
{
Console.WriteLine($"Entity: {entry.Entity.GetType().Name},
State: {entry.State.ToString()} ");
}
}
输出:
Entity: Student, State: Added
Entity: Student, State: Modified
在上面的示例中，newStudent没有Key属性值（StudentId）。因此，Update（）方法会将其标记为“已添加”，而modifiedStudent具有一个值，因此将其标记为“已修改”。
异常
如果DbContext的实例已经在跟踪具有相同键属性值的实体，则Update和UpdateRange方法将引发InvalidOperationException。考虑以下示例：
var student = new Student()
{
StudentId = 1,
Name = "Steve"
};
using (var context = new SchoolContext())
{
// 将内容加载到其StudentId为1的conext中
context.Students.First<Student>(s => s.StudentId == 1);
// 引发异常，因为它已经在跟踪带有StudentId = 1的实体
context.Update<Student>(student);
context.SaveChanges();
}
在上面的示例中，上下文对象加载了StudentId为1的Student实体，并开始对其进行跟踪。因此，附加具有相同键值的实体将引发以下异常：
The instance of entity type 'Student' cannot be tracked because another instance with the same key value for {'StudentId'} is already being tracked. When attaching existing entities, ensure that only one entity instance with a given key value is attached. Consider using 'DbContextOptionsBuilder.EnableSensitiveDataLogging' to see the conflicting key values.
无法跟踪实体类型“ Student”的实例，因为已经跟踪了另一个具有相同“ {'StudentId'}”键值的实例。附加现有实体时，请确保仅附加一个具有给定键值的实体实例。考虑使用'DbContextOptionsBuilder.EnableSensitiveDataLogging'查看有冲突的键值。
在下一章中学习在断开连接的情况下删除记录。
