using System;
using System.Data;
using System.Data.Common;

namespace System.Data.SqlClient
{
    // 摘要:
    //     表示要在 SQL Server 数据库中处理的 Transact-SQL 事务。无法继承此类。
    public sealed class SqlTransaction : DbTransaction
    {
        // 摘要:
        //     获取与该事务关联的 System.Data.SqlClient.SqlConnection 对象，或者如果该事务不再有效，则为 null。
        //
        // 返回结果:
        //     与该事务关联的 System.Data.SqlClient.SqlConnection 对象。
        public SqlConnection Connection { get; }
        protected override DbConnection DbConnection { get; }
        //
        // 摘要:
        //     指定该事务的 System.Data.IsolationLevel。
        //
        // 返回结果:
        //     该事务的 System.Data.IsolationLevel。默认为 ReadCommitted。
        public override IsolationLevel IsolationLevel { get; }

        // 摘要:
        //     提交数据库事务。
        //
        // 异常:
        //   System.Exception:
        //     尝试提交事务时出错。
        //
        //   System.InvalidOperationException:
        //     事务已提交或回滚。 - 或 - 连接已断开。
        public override void Commit();
        protected override void Dispose(bool disposing);
        //
        // 摘要:
        //     从挂起状态回滚事务。
        //
        // 异常:
        //   System.Exception:
        //     尝试提交事务时出错。
        //
        //   System.InvalidOperationException:
        //     事务已提交或回滚。 - 或 - 连接已断开。
        public override void Rollback();
        //
        // 摘要:
        //     从挂起状态回滚事务，并指定事务或保存点名称。
        //
        // 参数:
        //   transactionName:
        //     要回滚的事务的名称，或要回滚到的保存点的名称。
        //
        // 异常:
        //   System.ArgumentException:
        //     未指定事务名称。
        //
        //   System.InvalidOperationException:
        //     事务已提交或回滚。 - 或 - 连接已断开。
        public void Rollback(string transactionName);
        //
        // 摘要:
        //     在事务中创建保存点（它可用于回滚事务的一部分），并指定保存点名称。
        //
        // 参数:
        //   savePointName:
        //     保存点的名称。
        //
        // 异常:
        //   System.Exception:
        //     尝试提交事务时出错。
        //
        //   System.InvalidOperationException:
        //     事务已提交或回滚。 - 或 - 连接已断开。
        public void Save(string savePointName);
    }
}