方法:単一のトランザクションのスコープ内で実行する SQL Server の単体テストを作成する
単体テストは、単一のトランザクションのスコープ内で実行されるように変更できます。 この方法を使用すると、テストの終了後、テストによって行われた変更をロールバックできます。 次の手順では、以下の操作方法について説明します。
BEGIN TRANSACTION と ROLLBACK TRANSACTION を使用する Transact-SQL テスト スクリプト内にトランザクションを作成します。
テスト クラスで単一のテスト メソッドのトランザクションを作成します。
指定したテスト クラスですべてのテスト メソッドのトランザクションを作成します。
前提条件
このトピックの一部の手順では、分散トランザクション コーディネーター サービスを、単体テストを実行するコンピューターで実行している必要があります。 詳しくは、このトピックの最後にある手順をご覧ください。
Transact-SQL を使用してトランザクションを作成するには
Transact-SQL を使用してトランザクションを作成するには
SQL Server 単体テスト デザイナーで単体テストを開きます。 (デザイナーを表示するには、単体テストのソース コード ファイルをダブルクリックします)。
トランザクションを作成するスクリプトの種類を指定します。 たとえば、事前テスト、テスト、または事後テストを指定できます。
Transact-SQL エディターで、テスト スクリプトを入力します。
次の簡単な例に示すように、
BEGIN TRANSACTION
ステートメントとROLLBACK TRANSACTION
ステートメントを挿入します。 この例では、50 行のデータが格納された OrderDetails という名前のデータベース テーブルを使用します。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 Web サイトの「ROLLBACK TRANSACTION (Transact-SQL)」をご覧ください。
単一のテスト メソッドのトランザクションを作成するには
この例では、System.Transactions.TransactionScope 型を使用するときにアンビエント トランザクションを使用します。 既定では、実行接続および特権接続ではアンビエント トランザクションが使用されません。これらの接続は、メソッドが実行される前に作成されるためです。 SqlConnection には、トランザクションにアクティブな接続を関連付ける System.Data.SqlClient.SqlConnection.EnlistTransaction メソッドがあります。 アンビエント トランザクションを作成すると、そのトランザクション自体が現在のトランザクションとして登録されるため、System.Transactions.Transaction.Current プロパティを介してそのトランザクションにアクセスできます。 この例では、アンビエント トランザクションが破棄されると、トランザクションはロールバックされます。 単体テストの実行時に行われたすべての変更をコミットする場合は、System.Transactions.TransactionScope.Complete メソッドを呼び出す必要があります。
単一のテスト メソッドのトランザクションを作成するには
ソリューション エクスプローラーで、テスト プロジェクトの [参照設定] ノードを右クリックし、 [参照の追加] をクリックします。
[参照の追加] ダイアログ ボックスが表示されます。
[.NET] タブをクリックします。
アセンブリの一覧で、 [System.Transactions] をクリックし、 [OK] をクリックします。
単体テストの 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
Note
Visual Basic を使用している場合は、(
Imports Microsoft.VisualStudio.TestTools.UnitTesting
、Imports Microsoft.VisualStudio.TeamSystem.Data.UnitTesting
、およびImports Microsoft.VisualStudio.TeamSystem.Data.UnitTest.Conditions
に加えて)Imports System.Transactions
を追加する必要があります。Visual C# を使用している場合は、(Microsoft.VisualStudio.TestTools、Microsoft.VisualStudio.TeamSystem.Data.UnitTesting、および Microsoft.VisualStudio.TeamSystem.Data.UnitTesting.Conditions のusing
ステートメントに加えて)using System.Transactions
を追加する必要があります。 また、プロジェクトへの参照をこれらのアセンブリに追加する必要もあります。
テスト クラスですべてのテスト メソッドのトランザクションを作成するには
テスト クラスですべてのテスト メソッドのトランザクションを作成するには
単体テストの Visual Basic ファイルまたは C# ファイルを開きます。
次の Visual C# のコード例に示すように、TestInitialize でトランザクションを作成し、TestCleanup でそのトランザクションを破棄します。
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 アセンブリ内の型を使用します。 これらの手順を実行する前に、単体テストを実行するコンピューターで、分散トランザクション コーディネーター サービスが実行されていることを確認する必要があります。 サービスが実行されていない場合は、テストが失敗し、"テスト メソッド ProjectName.TestName.MethodName が例外をスローしました: System.Data.SqlClient.SqlException: サーバー 'ComputerName' の 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 アクセスを有効にする」をご覧ください。
参照
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示