System.Transactions 与 SQL Server 的集成

适用于: .NET Framework .NET .NET Standard

下载 ADO.NET

.NET 包含一个事务框架,可通过 System.Transactions 命名空间进行访问。 此框架以完全集成到 .NET 中的方式公开事务,包括 ADO.NET。

除了可编程性增强功能,System.Transactions 和 ADO.NET 还可以在你处理事务时协同工作以协调优化。 可提升事务是可以根据需要自动提升为完全分布式事务的轻型(本地)事务。

使用 SQL Server 时,Microsoft SqlClient Data Provider for SQL Server 支持可提升事务。 可提升的事务不会调用分布式事务增加的系统开销,除非需要增加的系统开销。 可提升事务是自动的,无需开发人员干预。

创建可提升事务

Microsoft SqlClient Data Provider for SQL Server 支持可提升事务,可通过 System.Transactions 命名空间中的类处理这种事务。 可提升事务通过将分布式事务推迟到需要时再创建,对分布式事务进行优化。 如果只需要一个资源管理器,则不会发生任何分布式事务。

备注

在部分信任方案中,将事务提升为分布式事务时,需要 DistributedTransactionPermission

可提升事务方案

分布式事务由 Microsoft 分布式事务处理协调器 (MS DTC) 管理,该协调程序集成了事务中访问的所有资源管理器,通常会占用大量的系统资源。 可提升事务是有效地将工作委托给简单 SQL Server 事务的 System.Transactions 事务的特殊形式。 System.TransactionsMicrosoft.Data.SqlClient 和 SQL Server 会对处理事务时涉及到的工作进行协调,并根据需要将其升级为完全分布式事务。

使用可提升事务的优点是在使用活动 TransactionScope 事务打开某个连接但不打开任何其他连接时,事务作为轻型事务提交,而不引发完全分布式事务的其他系统开销。

连接字符串关键字

ConnectionString 属性支持关键字 Enlist,该关键字指示 Microsoft.Data.SqlClient 是否将检测事务上下文并自动在分布式事务中登记连接。 如果 Enlist=true,连接将自动在打开的线程的当前事务上下文中登记。 如果 Enlist=falseSqlClient 连接不会与分布式事务进行交互。 Enlist 的默认值为 true。 如果连接字符串中未指定 Enlist ,而在连接打开时检测到一个连接,连接将自动在分布式事务中登记。

Transaction Binding 连接字符串中的 SqlConnection 关键字控制连接与已登记的 System.Transactions 事务的关联。 还可以通过 TransactionBindingSqlConnectionStringBuilder属性使用。

下表说明可用的值。

关键字 说明
Implicit Unbind 默认值。 事务结束时,连接与事务分离,切换回自动提交模式。
Explicit Unbind 事务关闭之前,连接保持附加到事务。 如果关联的事务未处于活动状态或不匹配 Current,则连接将失败。

使用 TransactionScope

TransactionScope 类通过在分布式事务中隐式登记连接,使代码块成为事务代码。 必须在 Complete 块的结尾调用 TransactionScope 方法,然后再离开该代码块。 离开代码块将调用 Dispose 方法。 如果引发的异常造成代码离开范围,将认为事务已中止。

我们建议您使用 using 块,以确保在退出 using 代码块时,在 Dispose 对象上调用 TransactionScope 。 如果无法提交或回滚挂起的事务,可能会对性能造成严重影响,因为 TransactionScope 的默认超时为一分钟。 如果未使用 using 语句,必须在 Try 块中执行所有工作,并在 Dispose 块中显式调用 Finally 方法。

如果在 TransactionScope中发生异常,事务将标记为不一致并被弃用。 在 TransactionScope 断开后,事务将回滚。 如果未发生异常,则提交参与的事务。

备注

默认情况下,TransactionScope 类创建 IsolationLevelSerializable 的事务。 根据您的应用程序,您可能希望考虑降低隔离级别,以避免在应用程序中发生争用激烈的情况。

备注

我们建议您只在分布式事务中执行更新、插入和删除,因为这些操作会占用大量的数据库资源。 选择语句可能会对数据库资源进行不必要的锁定,在某些方案中,可能需要使用事务进行选择。 任何非数据库工作应在事务范围之外完成,除非工作涉及其他事务化的资源管理器。 尽管事务范围内的异常会使事务无法提交,但是, TransactionScope 类没有规定回滚您的代码在事务本身范围之外所作的任何更改。 如果在事务回滚时需要采取某项措施,必须自己编写 IEnlistmentNotification 接口的实现并显式在事务中登记。

示例

使用 System.Transactions 要求具有 System.Transactions.dll 的引用。

下面的函数演示如何针对包装在 SqlConnection 块中的两个不同 SQL Server 实例(由两个不同的 TransactionScope 对象表示)创建可提升事务。

以下代码创建带有 TransactionScope 语句的 using 块,并打开第一个在 TransactionScope 中自动登记的连接。

该事务最初作为轻型事务登记,而不是完全分布式事务。 仅当第一个连接中的命令没有引发异常时,才会在 TransactionScope 中登记第二个连接。 打开第二个连接后,事务将自动提升为完全分布式事务。

稍后,将调用 Complete 方法,该方法仅在未引发异常时提交事务。 如果在 TransactionScope 代码块中的任意位置引发了异常,将不会调用 Complete ,当在 TransactionScopeusing 代码块结尾处执行 dispose 后,将回滚分布式事务。

using System;
using System.Transactions;
using Microsoft.Data.SqlClient;

class Program
{
    static void Main(string[] args)
    {
        string connectionString = "Data Source = localhost; Integrated Security = true; Initial Catalog = AdventureWorks";

        string commandText1 = "INSERT INTO Production.ScrapReason(Name) VALUES('Wrong size')";
        string commandText2 = "INSERT INTO Production.ScrapReason(Name) VALUES('Wrong color')";

        int result = CreateTransactionScope(connectionString, connectionString, commandText1, commandText2);

        Console.WriteLine("result = " + result);
    }

    static public int CreateTransactionScope(string connectString1, string connectString2,
                                            string commandText1, string commandText2)
    {
        // Initialize the return value to zero and create a StringWriter to display results.  
        int returnValue = 0;
        System.IO.StringWriter writer = new System.IO.StringWriter();

        // Create the TransactionScope in which to execute the commands, guaranteeing  
        // that both commands will commit or roll back as a single unit of work.  
        using (TransactionScope scope = new TransactionScope())
        {
            using (SqlConnection connection1 = new SqlConnection(connectString1))
            {
                try
                {
                    // Opening the connection automatically enlists it in the
                    // TransactionScope as a lightweight transaction.  
                    connection1.Open();

                    // Create the SqlCommand object and execute the first command.  
                    SqlCommand command1 = new SqlCommand(commandText1, connection1);
                    returnValue = command1.ExecuteNonQuery();
                    writer.WriteLine("Rows to be affected by command1: {0}", returnValue);

                    // if you get here, this means that command1 succeeded. By nesting  
                    // the using block for connection2 inside that of connection1, you  
                    // conserve server and network resources by opening connection2
                    // only when there is a chance that the transaction can commit.
                    using (SqlConnection connection2 = new SqlConnection(connectString2))
                        try
                        {
                            // The transaction is promoted to a full distributed  
                            // transaction when connection2 is opened.  
                            connection2.Open();

                            // Execute the second command in the second database.  
                            returnValue = 0;
                            SqlCommand command2 = new SqlCommand(commandText2, connection2);
                            returnValue = command2.ExecuteNonQuery();
                            writer.WriteLine("Rows to be affected by command2: {0}", returnValue);
                        }
                        catch (Exception ex)
                        {
                            // Display information that command2 failed.  
                            writer.WriteLine("returnValue for command2: {0}", returnValue);
                            writer.WriteLine("Exception Message2: {0}", ex.Message);
                        }
                }
                catch (Exception ex)
                {
                    // Display information that command1 failed.  
                    writer.WriteLine("returnValue for command1: {0}", returnValue);
                    writer.WriteLine("Exception Message1: {0}", ex.Message);
                }
            }

            // If an exception has been thrown, Complete will not
            // be called and the transaction is rolled back.  
            scope.Complete();
        }

        // The returnValue is greater than 0 if the transaction committed.  
        if (returnValue > 0)
        {
            writer.WriteLine("Transaction was committed.");
        }
        else
        {
            // You could write additional business logic here, notify the caller by  
            // throwing a TransactionAbortedException, or log the failure.  
            writer.WriteLine("Transaction rolled back.");
        }

        // Display messages.  
        Console.WriteLine(writer.ToString());

        return returnValue;
    }
}

另请参阅