TransactionScope事务处理方法介绍及.NET Core中的注意事项

作者：依乐祝

原文链接：https://www.cnblogs.com/yilezhu/p/10170712.html

今天在写CzarCms的UnitOfWork的使用使用到了这个TransactionScope事务，因此对它进行了相关资料的查阅并记录如下，希望对大伙在.NET Core中使用有所帮助。

写在前面

您是否曾尝试使用C＃代码来实现事务？通常，我们在SQL中一次执行多个Insert / Update语句的话可能就会使用到事务。事务遵循ACID（原子性，一致性，隔离性，持久性）规则，这样所有的语句要么全部执行成功要么全部被取消并执行回滚操作。而我们今天要讲的TransactionScope则可以允许我们在应用程序级别实现这个过程。在某些情况下，您可能需要在同一个数据库甚至多个数据库（分布式事务）中执行不同的操作，或者由于某些其他约束，它无法在数据库级别来完成，或者应用程序的开发人员对数据库的接触较少，那么这时候TransactionScope将会让你游刃有余。

什么是TransactionScope呢？

TransactionScope作为System.Transactions的一部分被引入到.NET 2.0。同时SqlClient for .NET Core 从 2.1 及以上版本开始提供对System.Transactions的支持。它是一个类，它提供了一种简单的方法，可以将一组操作作为事务的一部分来进行处理，而不必担心场景背后的复杂性。如果某个操作在执行的过程中失败的话，则整个事务将失败并执行回滚操作，从而撤消已完成的所有操作。所有这些都将由框架处理，从而确保数据的一致性。

如何使用TransactionScope呢？

要使用它，您需要添加System.Transactions的引用，如果你使用的是.net core的话。这个引用被包含在netcoreapp2.2\System.Transactions.Local.dll 中，该引用是框架库的一部分（通常默认情况下不会自动添加）。添加后，在我们想要使用它的地方添加名称空间 System.Transactions即可。代码如下所示：

try

{

    using (TransactionScope scope = new TransactionScope())

    {

        // Do Operation 1

        // Do Operation 2

        //...

        // 如果所有的操作都执行成功，则Complete()会被调用来提交事务

        // 如果发生异常，则不会调用它并回滚事务

        scope.Complete();

    }

}

catch (ThreadAbortException ex)

{

    // 处理异常

}

在上面的代码中我们可以看到我们在创建TransactionScope实例时使用了using 语句块及Disposable块，它确保了当dispose离开块并结束事务范围时调用dispose来进行资源的释放。

在一个Transaction范围中，我们可以做多个连接甚至链接到不同数据库的操作的，如下所示：

using (TransactionScope scope = new TransactionScope())

{

    using (con = new SqlConnection(conString1))

    {

        con.Open();

        // 执行操作 1

        // 执行操作 2

        //...

    }

    using (con = new SqlConnection(conString2))

    {

        con.Open();

        // 执行操作 1

        // 执行操作 2

        //...

    }

    scope.Complete();

}

下面我们使用两个不同的数据库连接字符串来连接不同的数据库。当然我们也可以根据我们的业务要求使用尽可能多数据库。我们也可以再事务中嵌套事务。如下代码所示：

public void DoMultipleTransaction()

{

    try

    {

        using (TransactionScope scope = new TransactionScope())

        {

            using (con = new SqlConnection(conString1))

            {

                con.Open();

                // 执行操作1

            }

            OtherTransaction();

            scope.Complete();

        }

    }

    catch (ThreadAbortException ex)

    {

        // 处理异常

    }

}

private void OtherTransaction()

{

    using (TransactionScope scope = new TransactionScope())

    {

        using (con = new SqlConnection(conString2))

        {

            con.Open();

            // 执行操作

        }

        scope.Complete();

    }

}

这里最顶层的事务范围称为根范围。另外这里需要注意的是即使通过调用scope.Complete（）完成内部事务（上面的OtherTransaction ），如果由于各种原因无法调用rootscope complete，那么整个事务也将被回滚包括内部的事务。

*注意：执行分布式trsanctions时，您可能会收到以下异常之一*

服务器上的MSDTC不可用
已禁用分布式事务管理器（MSDTC）的网络访问。

这两个错误都是由于同样的原因，第一个是在数据库和应用程序是同一个服务器时发生的，而在另一个则是服务跟数据库分别部署在两台服务器上。对于同一台服务器，请转到run-> cmd-> services.msc。运行名为Distributed Transaction Coordinator的服务并自动启动启动类型，以便在系统重新启动时再次启动它。对于2，你可能需要参照这个链接的内容进行相应的设置

TransactionScope 类提供了多个重载构造函数，它们接受 TransactionScopeOption 类型的枚举，而该枚举定义事务范围行为。

TransactionScope对象有以下三个选项：

Required：联接环境事务，或者在环境事务不存在的情况下创建新的环境事务。
RequiresNew：成为新的根范围，也就是说，启动一个新事务并使该事务成为其自己范围中的新环境事务。
Suppress：根本不参与事务。因此没有环境事务。

如果用 Required] 实例化范围并且存在环境事务，则该范围会联接该事务。相反，如果不存在环境事务，该范围就会创建新的事务并成为根范围。这是默认值。在使用 Required时，无论范围是根范围还是仅联接环境事务，该范围中的代码都不需要有不同的行为。该代码在这两种情况下的行为应相同。

如果用 RequiresNew 实例化范围，则它始终为根范围。它会启动一个新事务，并且其事务成为该范围中的新环境事务。

如果用 Suppress 实例化范围，则无论是否存在环境事务，范围都从不参与事务。始终使用此值实例化的作用域具有null作为其环境事务。

下面来让我们看一组实例代码：

using (TransactionScope scope = new TransactionScope())

{

    // 联接环境事务，或者在环境事务不存在的情况下创建新的环境事务。

    using (TransactionScope scope1 = new TransactionScope(TransactionScopeOption.Required))

    {

        // Do Operation

        scope1.Complete();

    }

    //成为新的根范围，也就是说，启动一个新事务并使该事务成为其自己范围中的新环境事务。

    using (TransactionScope scope2 = new TransactionScope(TransactionScopeOption.RequiresNew))

    {

        // Do Operation

        scope2.Complete();

    }

    //根本不参与事务。 因此没有环境事务。

    using (TransactionScope scope3 = new TransactionScope(TransactionScopeOption.Suppress))

    {

        // Do Operation

        scope3.Complete();

    }

    scope.Complet

在这里，我们使用不同的TransactionScopeOptions在父事务下创建了三个事务。默认情况下，范围是required ，这里父事务就是采用的这个默认参数进行创建的。它是一个创建新事务的根范围，并将其标记为环境事务。scope1也是使用required创建的，因为我们已经有了一个环境事务（范围），所以它加入到父事务中。scope2是使用RequiresNew选项创建的，这意味着它是一个独立于环境事务处理的新事务。scope3是用suppress创建的选项，这意味着它不参与任何环境事务。无论环境事务是否成功执行，它都会被执行。父（全局）范围完成后，将提交所有环境事务。

注意点

EF Core 依赖数据库提供程序以实现对 System.Transactions 的支持。虽然支持在 .NET Framework 的 ADO.NET 提供程序之间十分常见，但最近才将 API 添加到 .NET Core，因此支持并未得到广泛应用。如果提供程序未实现对 System.Transactions 的支持，则可能会完全忽略对这些 API 的调用。 SqlClient for .NET Core 从 2.1 及以上版本开始支持 System.Transactions。如果尝试在低版本中如.NET Core 2.0中尝试使用该功能将引发异常。
自版本 2.1 起，.NET Core 中的 System.Transactions 实现将不包括对分布式事务的支持，因此不能使用 TransactionScope 或 CommittableTransaction 来跨多个资源管理器协调事务。主要是不依赖windows中的mstsc功能。
异步方法使用时需要注意：

在下面的例子中，我们在TransactionScope内部使用await。
```
using（var scope = new TransactionScope（））

{

  var groups = await Context.ProductGroups.ToListAsync（）。ConfigureAwait（false）;

}
```
看起来没有问题，但它会抛出一个 System.InvalidOperationException:``A TransactionScope must be disposed on the same thread that it was created.

原因是默认情况下TransactionScope不会从一个线程切换到另一个线程。为了解决这个问题，我们必须使用 TransactionScopeAsyncFlowOption.Enabled：
```
using（var scope = new TransactionScope（TransactionScopeAsyncFlowOption.Enabled））

{

  var groups = await Context.ProductGroups.ToListAsync（）。ConfigureAwait（false）;

}
```
现在应该可以了吧？这取决于下面的情况。

如果我们使用和不使用TransactionScopeAsyncFlowOption这个选项的时候都使用了相同的数据库连接，并且第一次执行的时候没有使用这个选项，那么我们会得到另一个异常： System.InvalidOperationException:``Connection currently has transaction enlisted. Finish current transaction and retry.

换句话说，由于第一个访问的原因，第二个会话将会失败。如下代码所示：
```
try

{

  using (var scope = new TransactionScope())

  {

    // We know this one - System.InvalidOperationException:

    // TransactionScope必须放在与创建它相同的线程上。

    var groups = await Context.ProductGroups.ToListAsync().ConfigureAwait(false);

 }

}

catch (Exception e)

{

  // error handling

}

using (var scope = new TransactionScope(TransactionScopeAsyncFlowOption.Enabled))

{

  // Implemented correctly but throws anyways

  // System.InvalidOperationException:

  // 当前连接已经被记录。完成当前事务并重试。

  var groups = await Context.ProductGroups.ToListAsync().ConfigureAwait(false);

}
```
想象一下，如果第一个调用是在第三方库或您正在使用的框架中完成的，二您不了解其中的代码 - 如果您之前没有看到此错误，那么你讲无从下手来解决这个问题。

总结

本文带着大家熟悉了一遍TransactionScope并对其使用进行了介绍！同时介绍了在.NET Core中使用TransactionScope的一些注意事项！希望对大家有所帮助。另附上.NET Core实战项目交流群：637326624