HOW TO：撰寫會在單一交易範圍中執行的資料庫單元測試

發行項
08/12/2011

這個主題適用於：

Visual Studio Ultimate	Visual Studio Premium	Visual Studio 2010 Professional	Visual Studio Express

您可以修改單元測試，使其在單一交易範圍中執行。如果採用這種方法，即可以在測試結束之後，復原此測試所進行的任何變更。以下程序將解釋其作法：

在 Transact-SQL 測試指令碼中建立會使用 BEGIN TRANSACTION 和 ROLLBACK TRANSACTION 的交易。
在測試類別中建立單一測試方法的交易。
在指定的測試類別中建立所有測試方法的交易。

必要條件

對於本主題中的部分程序而言，必須在執行單元測試的電腦上執行分散式交易協調器 (DTC) 服務。如需詳細資訊，請參閱本主題最後的程序。

若要使用 Transact-SQL 建立交易

在資料庫單元測試設計工具中開啟單元測試。
指定您要建立交易的指令碼類型。例如，您可以指定前置測試、測試或後置測試。
在 Transact-SQL 編輯器中輸入測試指令碼。
插入 BEGIN TRANSACTION 和 ROLLBACK TRANSACTION 陳述式，如以下的簡單範例所示。這個範例使用名稱為 OrderDetails 的資料庫資料表，其中包含 50 個資料列：
```
BEGIN TRANSACTION TestTransaction
UPDATE "OrderDetails" set Quantity = Quantity + 10
IF @@ROWCOUNT!=50
RAISERROR('Row count does not equal 50',16,1)
ROLLBACK TRANSACTION TestTransaction
```
注意事項

在執行 COMMIT TRANSACTION 陳述式之後，就不能復原交易。

如需如何搭配預存程序和觸發程序使用 ROLLBACK TRANSACTION 的詳細資訊，請參閱 Microsoft 網站上的此網頁：ROLLBACK TRANSACTION (Transact-SQL)。

注意事項
在執行 COMMIT TRANSACTION 陳述式之後，就不能復原交易。

若要為單一測試方法建立交易

在這個範例中，您是在使用 TransactionScope 型別時使用環境交易。根據預設，執行連接和授權連接不會使用環境交易，因為這些連接是在執行方法前即已建立。 SqlConnection 擁有的 EnlistTransaction 方法會將作用中的連接與交易產生關聯。環境交易在建立時，會將自己註冊為目前的交易，而您可以透過 Current 屬性進行存取。在這個範例中，當環境交易經過處置後就會復原交易。如果想要認可在執行單元測試時進行的任何變更，您必須呼叫 Complete 方法。

若要為單一測試方法建立交易

在 [方案總管] 中，以滑鼠右鍵按一下測試專案中的 [參考] 節點，然後按一下 [加入參考]。

[加入參考] 對話方塊隨即出現。
按一下 [.NET] 索引標籤。
在組件清單中，按一下 [System.Transactions]，然後按一下 [確定]。
針對您的單元測試開啟 Visual Basic 或 C# 檔案。

包裝測試前、測試和測試後動作，如下列 Visual Basic 程式碼範例所示：

    <TestMethod()> _
    Public Sub dbo_InsertTable1Test()

        Using ts as New System.Transactions.TransactionScope( System.Transactions.TransactionScopeOption.Required)
            ExecutionContext.Connection.EnlistTransaction(Transaction.Current)
            PrivilegedContext.Connection.EnlistTransaction(Transaction.Current)

            Dim testActions As DatabaseTestActions = Me.dbo_InsertTable1TestData
            'Execute the pre-test script
            '
            System.Diagnostics.Trace.WriteLineIf((Not (testActions.PretestAction) Is Nothing), "Executing pre-test script...")
            Dim pretestResults() As ExecutionResult = TestService.Execute(Me.PrivilegedContext, Me.PrivilegedContext, testActions.PretestAction)
            'Execute the test script

            System.Diagnostics.Trace.WriteLineIf((Not (testActions.TestAction) Is Nothing), "Executing test script...")
            Dim testResults() As ExecutionResult = TestService.Execute(ExecutionContext, Me.PrivilegedContext, testActions.TestAction)

            'Execute the post-test script
            '
            System.Diagnostics.Trace.WriteLineIf((Not (testActions.PosttestAction) Is Nothing), "Executing post-test script...")
            Dim posttestResults() As ExecutionResult = TestService.Execute(Me.PrivilegedContext, Me.PrivilegedContext, testActions.PosttestAction)

            'Because the transaction is not explicitly committed, it
            'is rolled back when the ambient transaction is 
            'disposed.
            'To commit the transaction, remove the comment delimiter
            'from the following statement:
            'ts.Complete()

    End Sub
    Private dbo_InsertTable1TestData As DatabaseTestActions

注意事項
如果您是使用 Visual Basic，您必須新增 Imports System.Transactions (除了 Imports Microsoft.VisualStudio.TestTools.UnitTesting, Imports Microsoft.VisualStudio.TeamSystem.Data.UnitTesting 和 Imports Microsoft.VisualStudio.TeamSystem.Data.UnitTest.Conditions 之外)。如果您是使用 Visual C#，您必須新增 using System.Transactions (除了 Microsoft.VisualStudio.TestTools、Microsoft.VisualStudio.TeamSystem.Data.UnitTesting 和 Microsoft.VisualStudio.TeamSystem.Data.UnitTesting.Conditions 的 using 陳述式之外)。您也必須將專案的參考加入到這些組件。

如果您是使用 Visual Basic，您必須新增 Imports System.Transactions (除了 Imports Microsoft.VisualStudio.TestTools.UnitTesting, Imports Microsoft.VisualStudio.TeamSystem.Data.UnitTesting 和 Imports Microsoft.VisualStudio.TeamSystem.Data.UnitTest.Conditions 之外)。如果您是使用 Visual C#，您必須新增 using System.Transactions (除了 Microsoft.VisualStudio.TestTools、Microsoft.VisualStudio.TeamSystem.Data.UnitTesting 和 Microsoft.VisualStudio.TeamSystem.Data.UnitTesting.Conditions 的 using 陳述式之外)。您也必須將專案的參考加入到這些組件。

若要在測試類別中建立所有測試方法的交易

針對您的單元測試開啟 Visual Basic 或 C# 檔案。

在 TestInitialize 中建立交易，並在 TestCleanup 中加以處置，如下列 Visual C# 程式碼範例所示：

TransactionScope _trans;

        [TestInitialize()]
        public void Init()
        {
            _trans = new TransactionScope();
            base.InitializeTest();
        }

        [TestCleanup()]
        public void Cleanup()
        {
            base.CleanupTest();
            _trans.Dispose();
        }

        [TestMethod()]
        public void TransactedTest()
        {
            DatabaseTestActions testActions = this.DatabaseTestMethod1Data;
            // Execute the pre-test script
            // 
            System.Diagnostics.Trace.WriteLineIf((testActions.PretestAction != null), "Executing pre-test script...");
            ExecutionResult[] pretestResults = TestService.Execute(this.PrivilegedContext, this.PrivilegedContext, testActions.PretestAction);
            // Execute the test script
            // 
            System.Diagnostics.Trace.WriteLineIf((testActions.TestAction != null), "Executing test script...");
            ExecutionResult[] testResults = TestService.Execute(this.ExecutionContext, this.PrivilegedContext, testActions.TestAction);
            // Execute the post-test script
            // 
            System.Diagnostics.Trace.WriteLineIf((testActions.PosttestAction != null), "Executing post-test script...");
            ExecutionResult[] posttestResults = TestService.Execute(this.PrivilegedContext, this.PrivilegedContext, testActions.PosttestAction);

        }

若要啟動分散式交易協調器服務

本主題中的部分程序使用 System.Transactions 組件中的型別。在進行這些程序之前，您必須確定在執行單元測試的電腦上有執行分散式交易協調器 (DTC) 服務。否則測試就會失敗，並出現下列錯誤訊息：「測試方法 <專案名稱>.<測試名稱>.<方法名稱> 擲回例外狀況：System.Data.SqlClient.SqlException：伺服器 '<電腦名稱>' 上的 MSDTC 無法使用」。

若要啟動分散式交易協調器服務

開啟 [控制台]。
在 [控制台] 中，開啟 [系統管理工具]。
在 [系統管理工具] 中，開啟 [服務]。
在 [服務] 窗格中，以滑鼠右鍵按一下 [分散式交易控制器] 服務，然後按一下 [啟動]。

服務的狀態應該會更新為 [已啟動]。現在應該就能夠執行使用 System.Transactions 的單元測試。

重要事項
即使您已啟動分散式交易控制器服務，仍有可能發生下列錯誤：System.Transactions.TransactionManagerCommunicationException: Network access for Distributed Transaction Manager (MSDTC) has been disabled. Please enable DTC for network access in the security configuration for MSDTC using the Component Services Administrative tool. ---> System.Runtime.InteropServices.COMException: The transaction manager has disabled its support for remote/network transactions. (Exception from HRESULT: 0x8004D024)。如果發生這個錯誤，您必須針對網路存取設定分散式交易控制器。如需詳細資訊，請參閱啟用網路 DTC 存取 (英文)。

即使您已啟動分散式交易控制器服務，仍有可能發生下列錯誤：System.Transactions.TransactionManagerCommunicationException: Network access for Distributed Transaction Manager (MSDTC) has been disabled. Please enable DTC for network access in the security configuration for MSDTC using the Component Services Administrative tool. ---> System.Runtime.InteropServices.COMException: The transaction manager has disabled its support for remote/network transactions. (Exception from HRESULT: 0x8004D024)。如果發生這個錯誤，您必須針對網路存取設定分散式交易控制器。如需詳細資訊，請參閱啟用網路 DTC 存取 (英文)。

共用方式為

HOW TO：撰寫會在單一交易範圍中執行的資料庫單元測試

若要使用 Transact-SQL 建立交易

若要使用 Transact-SQL 建立交易

若要為單一測試方法建立交易

若要為單一測試方法建立交易

若要在測試類別中建立所有測試方法的交易

若要在測試類別中建立所有測試方法的交易

若要啟動分散式交易協調器服務

若要啟動分散式交易協調器服務

其他資源