IDbTransaction 인터페이스

데이터 소스에서 수행할 트랜잭션을 나타내고 관계형 데이터베이스에 액세스하는 .NET Framework 데이터 공급자에 의해 구현됩니다.

네임스페이스: System.Data
어셈블리: System.Data(system.data.dll)

구문

‘선언
Public Interface IDbTransaction
    Inherits IDisposable
‘사용 방법
Dim instance As IDbTransaction

public interface IDbTransaction : IDisposable

public interface class IDbTransaction : IDisposable

public interface IDbTransaction extends IDisposable

public interface IDbTransaction extends IDisposable

설명

IDbTransaction 인터페이스를 사용하면 데이터 소스에서 수행할 트랜잭션을 나타내는 Transaction 클래스를 상속 클래스에서 구현하게 할 수 있습니다. Transaction 클래스에 대한 자세한 내용은 트랜잭션 수행를 참조하십시오. .NET Framework 데이터 공급자 구현에 대한 자세한 내용은 Implementing a .NET Framework Data Provider을 참조하십시오.

응용 프로그램은 IDbTransaction 인터페이스의 인스턴스를 직접 만들지 않고 IDbTransaction을 상속하는 클래스의 인스턴스를 만듭니다.

IDbTransaction을 상속하는 클래스는 상속된 멤버를 구현해야 하며 일반적으로 공급자 고유의 기능을 추가하기 위한 추가 멤버를 정의합니다. 예를 들어 IDbTransaction 인터페이스는 Commit 메서드를 정의합니다. 그러면 OleDbTransaction 클래스가 이 속성을 상속하고 Begin 메서드도 정의합니다.

구현자 참고 사항 .NET Framework 데이터 공급자 간에 일관성을 유지하려면 상속 클래스 이름을 Prv Transaction 형식으로 지정합니다. 여기서 Prv는 특정 .NET Framework 데이터 공급자 네임스페이스의 모든 클래스에 사용되는 공통 접두사입니다. 예를 들어, Sql은 System.Data.SqlClient 네임스페이스에 있는 SqlTransaction 클래스의 접두사입니다.

예제

다음 예제에서는 파생 클래스의 인스턴스인 SqlConnection와 SqlTransaction을 만듭니다. BeginTransaction, Commit 및 Rollback 메서드를 사용하는 방법도 보여 줍니다.

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("SampleTransaction")

        ' 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

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("SampleTransaction");

        // 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);
            }
        }
    }
}

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

IDbTransaction 멤버
System.Data 네임스페이스