SqlTransaction 클래스

정의

SQL Server 데이터베이스에서 만들 Transact-SQL 트랜잭션을 나타냅니다. 이 클래스는 상속할 수 없습니다.

public ref class SqlTransaction sealed : MarshalByRefObject, IDisposable, System::Data::IDbTransaction
public ref class SqlTransaction sealed : System::Data::Common::DbTransaction
public sealed class SqlTransaction : MarshalByRefObject, IDisposable, System.Data.IDbTransaction
public sealed class SqlTransaction : System.Data.Common.DbTransaction
type SqlTransaction = class
    inherit MarshalByRefObject
    interface IDbTransaction
    interface IDisposable
type SqlTransaction = class
    inherit DbTransaction
Public NotInheritable Class SqlTransaction
Inherits MarshalByRefObject
Implements IDbTransaction, IDisposable
Public NotInheritable Class SqlTransaction
Inherits DbTransaction
상속
SqlTransaction
상속
구현

예제

다음 예제에서는 a 및 .를 SqlConnectionSqlTransaction만듭니다. 또한 , CommitRollback 메서드를 BeginTransaction사용하는 방법을 보여 줍니다. 트랜잭션은 오류가 발생하거나 먼저 커밋되지 않고 삭제된 경우 롤백됩니다. Try / Catch 오류 처리는 트랜잭션을 커밋하거나 롤백하려고 할 때 오류를 처리하는 데 사용됩니다.

private static void ExecuteSqlTransaction(string connectionString)
{
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();

        SqlCommand command = connection.CreateCommand();
        SqlTransaction transaction;

        // Start a local transaction.
        transaction = connection.BeginTransaction();

        // Must assign both transaction object and connection
        // to Command object for a pending local transaction
        command.Connection = connection;
        command.Transaction = transaction;

        try
        {
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
            command.ExecuteNonQuery();
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
            command.ExecuteNonQuery();

            // Attempt to commit the transaction.
            transaction.Commit();
            Console.WriteLine("Both records are written to database.");
        }
        catch (Exception ex)
        {
            Console.WriteLine("Commit Exception Type: {0}", ex.GetType());
            Console.WriteLine("  Message: {0}", ex.Message);

            // Attempt to roll back the transaction.
            try
            {
                transaction.Rollback();
            }
            catch (Exception ex2)
            {
                // This catch block will handle any errors that may have occurred
                // on the server that would cause the rollback to fail, such as
                // a closed connection.
                Console.WriteLine("Rollback Exception Type: {0}", ex2.GetType());
                Console.WriteLine("  Message: {0}", ex2.Message);
            }
        }
    }
}
Private Sub ExecuteSqlTransaction(ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()

        Dim command As SqlCommand = connection.CreateCommand()
        Dim transaction As SqlTransaction

        ' Start a local transaction
        transaction = connection.BeginTransaction()

        ' Must assign both transaction object and connection
        ' to Command object for a pending local transaction.
        command.Connection = connection
        command.Transaction = transaction

        Try
            command.CommandText = _
              "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')"
            command.ExecuteNonQuery()
            command.CommandText = _
              "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')"

            command.ExecuteNonQuery()

            ' Attempt to commit the transaction.
            transaction.Commit()
            Console.WriteLine("Both records are written to database.")

        Catch ex As Exception
            Console.WriteLine("Commit Exception Type: {0}", ex.GetType())
            Console.WriteLine("  Message: {0}", ex.Message)

            ' Attempt to roll back the transaction.
            Try
                transaction.Rollback()

            Catch ex2 As Exception
                ' This catch block will handle any errors that may have occurred
                ' on the server that would cause the rollback to fail, such as
                ' a closed connection.
                Console.WriteLine("Rollback Exception Type: {0}", ex2.GetType())
                Console.WriteLine("  Message: {0}", ex2.Message)
            End Try
        End Try
    End Using
End Sub

설명

애플리케이션은 개체를 SqlTransaction 호출 BeginTransaction 하여 개체를 SqlConnection 만듭니다. 트랜잭션과 연결된 모든 후속 작업(예: 트랜잭션 커밋 또는 중단)은 개체에서 SqlTransaction 수행됩니다.

Note

Try / Catch 예외 처리는 항상 .를 커밋하거나 롤백 SqlTransaction할 때 사용해야 합니다. Rollback 둘 다 Commit 연결이 종료되었거나 트랜잭션이 이미 서버에서 롤백된 경우를 생성 InvalidOperationException 합니다.

SQL Server 트랜잭션에 대한 자세한 내용은 Explicit TransactionsCoding Efficient Transactions 참조하세요.

속성

Name Description
Connection

SqlConnection 트랜잭션과 연결된 개체를 가져오거나 null 트랜잭션이 더 이상 유효하지 않은 경우 가져옵니다.

DbConnection

파생 클래스에서 재정의되는 경우 트랜잭션과 연결된 개체를 가져옵니다 DbConnection .

(다음에서 상속됨 DbTransaction)
IsolationLevel

이 트랜잭션에 대한 값을 IsolationLevel 지정합니다.

메서드

Name Description
Commit()

데이터베이스 트랜잭션을 커밋합니다.

CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시를 생성하는 데 필요한 모든 관련 정보를 포함하는 개체를 만듭니다.

(다음에서 상속됨 MarshalByRefObject)
Dispose()

개체가 보유한 리소스를 해제합니다.

Dispose()

에서 사용하는 DbTransaction관리되지 않는 리소스를 해제합니다.

(다음에서 상속됨 DbTransaction)
Dispose(Boolean)

관리되지 않는 리소스를 DbTransaction 해제하고 관리되는 리소스를 선택적으로 해제합니다.

(다음에서 상속됨 DbTransaction)
Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재 수명 서비스 개체를 검색합니다.

(다음에서 상속됨 MarshalByRefObject)
GetType()

현재 인스턴스의 Type 가져옵니다.

(다음에서 상속됨 Object)
InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.

(다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()

현재 Object단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.

(다음에서 상속됨 MarshalByRefObject)
Rollback()

보류 중인 상태에서 트랜잭션을 롤백합니다.

Rollback(String)

보류 중인 상태에서 트랜잭션을 롤백하고 트랜잭션 또는 저장점 이름을 지정합니다.

Save(String)

트랜잭션의 일부를 롤백하는 데 사용할 수 있는 저장점을 트랜잭션에 만들고 저장점 이름을 지정합니다.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

Name Description
IDbTransaction.Connection

DbConnection 트랜잭션과 연결된 개체를 가져오거나 트랜잭션이 더 이상 유효하지 않은 경우 null 참조를 가져옵니다.

(다음에서 상속됨 DbTransaction)

적용 대상

추가 정보