• 使用事务
    • 默认的事务行为
    • 事务控制
    • 跨上下文事务(仅关系数据库适用)
      • 允许外部提供链接
      • 共享连接和事务
    • 使用外部 DbTransactions(仅关系数据库适用)

    使用事务

    事务允许以原子方式处理多个数据库操作。如果事务已提交,那么说明所有操作都已被成功地应用到数据库。如果事务被回滚,那么没有任何一个操作会被应用到了数据库。

    提示

    你可以在 GitHub 上查阅当前文章涉及的代码样例。

    默认的事务行为

    默认情况下,如果数据库提供程序支持事务,单个 SaveChanges() 调用中的所有变更都会在一个事务中被提交。如果其中任何一个变更失败了,那么事务就会回滚,没有任何变更会被应用到数据库。这意味着 SaveChanges() 能够确保要么成功保存,要么在发生错误时不对数据库做任何修改。

    对于大部分应用程序来说,默认的事务行为已经够用了。只有在应用程序需求认为有必要时你才需要手动去控制事务。

    事务控制

    可以使用 DbContext.Database API 来开启、提交 和 回滚事务。以下代码样例显示了两个 SaveChanges() 操作和一个在单一事务中执行的 LINQ 查询。

    并不是所有的数据库提供程序都支持事务,一些提供程序会在你调用事务 API 时抛出异常或执行空操作(你可以顺带了解一下 空对象模式,Null Object Patterns)。

    1. using (var context = new BloggingContext())
    2. {
    3. using (var transaction = context.Database.BeginTransaction())
    4. {
    5. try
    6. {
    7. context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
    8. context.SaveChanges();
    9. context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/visualstudio" });
    10. context.SaveChanges();
    11. var blogs = context.Blogs
    12. .OrderBy(b => b.Url)
    13. .ToList();
    14. // 所有命令都成功时提交事务
    15. // 如果任何一个命令失败,则在事务被回收(Dispose)时会自动回滚
    16. transaction.Commit();
    17. }
    18. catch (Exception)
    19. {
    20. // TODO: 处理失败
    21. }
    22. }
    23. }

    跨上下文事务(仅关系数据库适用)

    可以在多个上下文实例间共享事务。该功能只在使用关系数据库提供程序时可用,因为它需要使用 DbTransactionDbConnection,这些都是特定于关系数据库的。

    为了实现共享事务,上下文之间必须共享 DbConnectionDbTransaction

    允许外部提供链接

    共享 DbConnection 要求能够在构造上下文实例时传入链接对象。

    实现外部提供 DbConnection 的最简单方式是避免使用 DbContext.OnConfiguring 方法来配置上下文,并且在其外部创建 DbConetxtOpions,然后将其传递给上下文类型的构造方法。

    提示

    DbContextOptionsBuilder 是你在 DbContext.OnConfiguring 中用来配置上下文实例的 API,现在你将在外部使用它来创建 DbContextOptions

    1. public class BloggingContext : DbContext
    2. {
    3. public BloggingContext(DbContextOptions<BloggingContext> options)
    4. : base(options)
    5. { }
    6. public DbSet<Blog> Blogs { get; set; }
    7. }

    另一种替代方案是仍然使用 DbContext.OnConfiguring,但是接受并保存一个 DbConnection,然后在 DbContext.OnConfiguring 中使用它。

    1. public class BloggingContext : DbContext
    2. {
    3. private DbConnection _connection;
    4. public BloggingContext(DbConnection connection)
    5. {
    6. _connection = connection;
    7. }
    8. public DbSet<Blog> Blogs { get; set; }
    9. protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    10. {
    11. optionsBuilder.UseSqlServer(_connection);
    12. }
    13. }

    共享连接和事务

    现在可以创建共享同一个连接的多个上下文了。之后可以使用DbContext.Database.UseTransaction(DbTransaction)) API 来在一个事务中收集这些上下文。

    1. var options = new DbContextOptionsBuilder<BloggingContext>()
    2. .UseSqlServer(new SqlConnection(connectionString))
    3. .Options;
    4. using (var context1 = new BloggingContext(options))
    5. {
    6. using (var transaction = context1.Database.BeginTransaction())
    7. {
    8. try
    9. {
    10. context1.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
    11. context1.SaveChanges();
    12. using (var context2 = new BloggingContext(options))
    13. {
    14. context2.Database.UseTransaction(transaction.GetDbTransaction());
    15. var blogs = context2.Blogs
    16. .OrderBy(b => b.Url)
    17. .ToList();
    18. }
    19. // 所有命令都成功时提交事务
    20. // 如果任何一个命令失败,则在事务被回收(Dispose)时会自动回滚
    21. transaction.Commit();
    22. }
    23. catch (Exception)
    24. {
    25. // TODO: 处理失败
    26. }
    27. }
    28. }

    使用外部 DbTransactions(仅关系数据库适用)

    如果你正在使用多个数据访问技术来访问关系数据库,那么你可能会想要在这些不同技术执行的操作中共享事务。

    以下代码样例显示了如何在同一个事务中执行一个 ADO.NET SqlClient 操作和一个 Entity Framework Core 操作。

    1. var connection = new SqlConnection(connectionString);
    2. connection.Open();
    3. using (var transaction = connection.BeginTransaction())
    4. {
    5. try
    6. {
    7. // 在事务中运行原生 ADO.NET 命令
    8. var command = connection.CreateCommand();
    9. command.Transaction = transaction;
    10. command.CommandText = "DELETE FROM dbo.Blogs";
    11. command.ExecuteNonQuery();
    12. // 在事务中运行 EF Core 命令
    13. var options = new DbContextOptionsBuilder<BloggingContext>()
    14. .UseSqlServer(connection)
    15. .Options;
    16. using (var context = new BloggingContext(options))
    17. {
    18. context.Database.UseTransaction(transaction);
    19. context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
    20. context.SaveChanges();
    21. }
    22. // 所有命令都成功时提交事务
    23. // 如果任何一个命令失败,则在事务被回收(Dispose)时会自动回滚
    24. transaction.Commit();
    25. }
    26. catch (System.Exception)
    27. {
    28. // TODO: 处理失败
    29. }
    30. }