Entity Framework Core系列教程-17-断开模式下更新数据

￡神魔★判官ぃ 2021-07-26 23:33 363阅读 0赞

# Entity Framework Core 断开连接场景中更新数据 #

EF Core API会为EntityState已修改的实体在数据库中生成并执行UPDATE语句。在连接的场景中，DbContext会跟踪所有实体，因此它知道哪些实体被修改，因此会自动将EntityState设置为Modified。

在断开连接的情况下（例如，在Web应用程序中），DbContext不知道实体，因为修改的实体超出了当前DbContext实例的范围。因此，首先我们需要将断开连接的实体附加到具有修改后的EntityState的DbContext实例。

下表列出了用于更新实体的DbContext和DbSet方法：

<table> 
 <thead> 
  <tr> 
   <th><strong>DbContext方法</strong></th> 
   <th><strong>DbSet方法</strong></th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>DbContext.Update</td> 
   <td>DbSet.Update</td> 
   <td>DbSet.Update将实体附加到具有修改状态的DbContext</td> 
  </tr> 
  <tr> 
   <td>DbContext.UpdateRange</td> 
   <td>DbSet.UpdateRange</td> 
   <td>DbSet.UpdateRange将实体集合附加到具有修改状态的DbContext</td> 
  </tr> 
 </tbody> 
</table>

下面的示例演示如何更新断开连接的实体。

// 断开连接的学生实体
    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。

如您所见，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'查看有冲突的键值。

在下一章中学习在断开连接的情况下删除记录。