TransactionScope.Dispose 메서드

정의

네임스페이스:

System.Transactions

어셈블리:

System.Transactions.Local.dll

Source:

TransactionScope.cs

트랜잭션 범위를 종료합니다.

public:
 virtual void Dispose();

public void Dispose ();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

구현

Dispose()

예제

다음 예제에서는 사용 TransactionScope 하는 방법에 설명 합니다 클래스는 트랜잭션에 참여 하는 코드 블록을 정의 합니다.

// This function takes arguments for 2 connection strings and commands to create a transaction 
// involving two SQL Servers. It returns a value > 0 if the transaction is committed, 0 if the 
// transaction is rolled back. To test this code, you can connect to two different databases 
// on the same server by altering the connection string, or to another 3rd party RDBMS by 
// altering the code in the connection2 code block.
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();

    try
    {
        // Create the TransactionScope to execute the commands, guaranteeing
        // that both commands can commit or roll back as a single unit of work.
        using (TransactionScope scope = new TransactionScope())
        {
            using (SqlConnection connection1 = new SqlConnection(connectString1))
            {
                // 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 as connection2 is opened
                // only when there is a chance that the transaction can commit.   
                using (SqlConnection connection2 = new SqlConnection(connectString2))
                {
                    // The transaction is escalated 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);
                }
            }

            // The Complete method commits the transaction. If an exception has been thrown,
            // Complete is not  called and the transaction is rolled back.
            scope.Complete();
        }
    }
    catch (TransactionAbortedException ex)
    {
        writer.WriteLine("TransactionAbortedException Message: {0}", ex.Message);
    }

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

    return returnValue;
}

'  This function takes arguments for 2 connection strings and commands to create a transaction 
'  involving two SQL Servers. It returns a value > 0 if the transaction is committed, 0 if the 
'  transaction is rolled back. To test this code, you can connect to two different databases 
'  on the same server by altering the connection string, or to another 3rd party RDBMS  
'  by altering the code in the connection2 code block.
Public Function CreateTransactionScope( _
  ByVal connectString1 As String, ByVal connectString2 As String, _
  ByVal commandText1 As String, ByVal commandText2 As String) As Integer

    ' Initialize the return value to zero and create a StringWriter to display results.
    Dim returnValue As Integer = 0
    Dim writer As System.IO.StringWriter = New System.IO.StringWriter

    Try
    ' Create the TransactionScope to execute the commands, guaranteeing
    '  that both commands can commit or roll back as a single unit of work.
        Using scope As New TransactionScope()
            Using connection1 As New SqlConnection(connectString1)
                ' Opening the connection automatically enlists it in the 
                ' TransactionScope as a lightweight transaction.
                connection1.Open()

                ' Create the SqlCommand object and execute the first command.
                Dim command1 As SqlCommand = 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 as connection2 is opened
                ' only when there is a chance that the transaction can commit.   
                Using connection2 As New SqlConnection(connectString2)
                    ' The transaction is escalated to a full distributed
                    ' transaction when connection2 is opened.
                    connection2.Open()

                    ' Execute the second command in the second database.
                    returnValue = 0
                    Dim command2 As SqlCommand = New SqlCommand(commandText2, connection2)
                    returnValue = command2.ExecuteNonQuery()
                    writer.WriteLine("Rows to be affected by command2: {0}", returnValue)
                End Using
            End Using

        ' The Complete method commits the transaction. If an exception has been thrown,
        ' Complete is called and the transaction is rolled back.
        scope.Complete()
        End Using
    Catch ex As TransactionAbortedException
        writer.WriteLine("TransactionAbortedException Message: {0}", ex.Message)
    End Try

    ' Display messages.
    Console.WriteLine(writer.ToString())

    Return returnValue
End Function

설명

이 메서드를 호출하면 트랜잭션 scope 종료됩니다. 개체가 트랜잭션 Complete 을 TransactionScope 만들고 scope 호출된 경우 개체는 TransactionScope 이 메서드가 호출되면 트랜잭션을 커밋하려고 시도합니다. 이 경우 이 메서드는 트랜잭션 처리의 첫 번째 단계가 완료될 때까지 차단합니다. 첫 번째 단계는 트랜잭션의 모든 리소스 관리자 및 인리스트먼트가 트랜잭션 결과에 대해 투표하고 TransactionManager 가 트랜잭션을 커밋하거나 중단하기로 결정한 후에 종료됩니다. 처리의 두 번째 단계는 항상 비동기입니다. 따라서 이 데이터를 보기 위해 다른 트랜잭션을 사용하지 않을 때 지정된 트랜잭션 내에서 방금 커밋된 데이터를 나중에 즉시 사용할 수 있다는 보장은 없습니다.

C# using 생성을 사용하면 예외가 발생하더라도 이 메서드가 호출됩니다. 이 메서드를 호출한 후에 발생하는 예외는 트랜잭션에 영향을 미치지 않을 수 있습니다. 또한 이 메서드는 앰비언트 트랜잭션을 원래 상태로 복원합니다. TransactionAbortedException 트랜잭션이 실제로 커밋되지 않은 경우 이 throw됩니다.

이 메서드 차단 트랜잭션 처리의 첫 번째 단계 완료 될 때까지, 매우 주의 해야 애플리케이션을 Windows Form (WinForm) 또는 교착 상태에서이 메서드를 사용 하는 경우 발생할 수 있습니다 때문에. 한 WinForm Control 이벤트(예: 단추 클릭)에서 이 메서드를 호출하고 동기 Invoke 메서드를 사용하여 트랜잭션 처리 도중에 컨트롤이 일부 UI 작업(예: 색 변경)을 수행하도록 지시하면 교착 상태가 발생합니다. 이는 메서드가 Invoke 동기적이며 UI 스레드가 작업을 완료할 때까지 작업자 스레드를 차단하기 때문입니다. 그러나 이 시나리오에서 UI 스레드는 작업자 스레드가 트랜잭션을 커밋할 때까지 기다리고 있습니다. 그 결과 아무도 진행할 수 없으며 scope 커밋이 완료되기를 무기한 기다립니다. 비동기적이므로 교착 상태가 발생하기 쉽기 때문에 가능한 경우 대신 Invoke 를 사용해야 BeginInvoke 합니다.

이 메서드를 사용하는 방법에 대한 자세한 내용은 트랜잭션 범위를 사용하여 암시적 트랜잭션 구현 항목을 참조하세요.

추가 정보

• 트랜잭션 범위를 사용하여 암시적 트랜잭션 구현