共用方式為

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

  • 發行項

更新：2007 年 11 月

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

  • 在 Transact-SQL (T-SQL) 測試指令碼中建立會使用 BEGIN TRANSACTION 和 ROLLBACK TRANSACTION 的交易。

  • 在測試類別中建立單一測試方法的交易。

  • 在指定的測試類別中建立所有測試方法的交易。

必要條件

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

若要使用 T-SQL 建立交易

若要使用 T-SQL 建立交易

  1. 在資料庫單元測試設計工具中開啟單元測試。

  2. 指定您要建立交易的指令碼類型。例如，您可以指定前置測試、測試或後置測試。

  3. 在 T-SQL 編輯器中輸入測試指令碼。

  4. 插入 BEGIN TRANSACTION 和 ROLLBACK TRANSACTION 陳述式，如以下的簡單範例所示。這個範例使用 Northwind 資料庫資料表，其中包含 50 個資料列：

    BEGIN TRANSACTION TestTransaction
UPDATE "Order Details" 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)。

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

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

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

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

  2. 包裝測試前、測試和測試後動作，如下列 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, and 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 陳述式之外)。您也必須將專案的參考加入到這些組件。

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

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

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

  2. 在 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) 服務。否則測試就會失敗，並出現下列錯誤訊息：「測試方法 ProjectName.TestName.MethodName 擲回例外狀況：System.Data.SqlClient.SqlException：伺服器 'ComputerName' 上的 MSDTC 無法使用」。

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

  1. 開啟 [控制台]。

  2. 在 [控制台] 中，開啟 [系統管理工具]。

  3. 在 [系統管理工具] 中，開啟 [服務]。

  4. 在 [服務] 窗格中，以滑鼠右鍵按一下 [分散式交易協調器] 服務，然後按一下 [啟動]。

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