다음을 통해 공유


SqlTransaction 클래스

정의

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

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

예제

다음 예제에서는 및 를 SqlConnectionSqlTransaction만듭니다. 사용 하는 방법을 보여 줍니다 합니다 BeginTransaction, Commit, 및 Rollback 메서드. 트랜잭션은 오류가 발생하거나 먼저 커밋되지 않고 삭제된 경우 롤백됩니다. 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 호출 하 여 개체 BeginTransactionSqlConnection 개체입니다. 트랜잭션과 연결된 모든 후속 작업(예: 트랜잭션 커밋 또는 중단)은 개체에서 SqlTransaction 수행됩니다.

참고

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

SQL Server 트랜잭션에 대한 자세한 내용은 명시적 트랜잭션 및코딩 효율적인 트랜잭션을 참조하세요.

속성

Connection

트랜잭션과 관련된 SqlConnection 개체를 가져오거나 트랜잭션이 더 이상 유효하지 않으면 null입니다.

DbConnection

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

(다음에서 상속됨 DbTransaction)
IsolationLevel

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

SupportsSavepoints

DbTransaction 인스턴스가 데이터베이스 저장점을 지원하는지 여부를 나타내는 값을 가져옵니다. false인 경우 SaveAsync(String, CancellationToken), RollbackAsync(String, CancellationToken)ReleaseAsync(String, CancellationToken) 메서드와 해당 동기 메서드에서 NotSupportedException을 throw할 것으로 예상됩니다.

(다음에서 상속됨 DbTransaction)

메서드

Commit()

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

CommitAsync(CancellationToken)

데이터베이스 트랜잭션을 비동기적으로 커밋합니다.

(다음에서 상속됨 DbTransaction)
CreateObjRef(Type)

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

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

개체에서 보유하는 리소스를 해제합니다.

Dispose()

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

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

DbTransaction에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.

(다음에서 상속됨 DbTransaction)
DisposeAsync()

트랜잭션 개체를 비동기적으로 삭제합니다.

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

지정된 개체가 현재 개체와 같은지 확인합니다.

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

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

(다음에서 상속됨 Object)
GetLifetimeService()
사용되지 않음.

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

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

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

(다음에서 상속됨 Object)
InitializeLifetimeService()
사용되지 않음.

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

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

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

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

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

(다음에서 상속됨 MarshalByRefObject)
Release(String)

현재 트랜잭션에 이전에 정의된 저장점을 제거합니다. 이렇게 하면 트랜잭션이 종료되기 전에 시스템에서 일부 리소스를 회수할 수 있습니다.

(다음에서 상속됨 DbTransaction)
ReleaseAsync(String, CancellationToken)

현재 트랜잭션에 이전에 정의된 저장점을 제거합니다. 이렇게 하면 트랜잭션이 종료되기 전에 시스템에서 일부 리소스를 회수할 수 있습니다.

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

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

Rollback(String)

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

RollbackAsync(CancellationToken)

보류 중 상태에서 트랜잭션을 비동기적으로 롤백합니다.

(다음에서 상속됨 DbTransaction)
RollbackAsync(String, CancellationToken)

지정된 저장점이 설정된 후에 실행된 모든 명령을 롤백합니다.

(다음에서 상속됨 DbTransaction)
Save(String)

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

SaveAsync(String, CancellationToken)

트랜잭션에 저장점을 만듭니다. 이렇게 하면 저장점이 설정된 후에 실행되는 모든 명령을 롤백하여 트랜잭션 상태를 저장점 시점의 상태로 복원할 수 있습니다.

(다음에서 상속됨 DbTransaction)
ToString()

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

(다음에서 상속됨 Object)

명시적 인터페이스 구현

IDbTransaction.Connection

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

(다음에서 상속됨 DbTransaction)

적용 대상

추가 정보