CommittableTransaction クラス

.NET Framework クラス ライブラリ リファレンス

CommittableTransaction クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

コミットできるトランザクションを示します。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public NotInheritable Class
 CommittableTransaction
    Inherits Transaction
    Implements IAsyncResult

Visual Basic (使用法)

Dim instance As CommittableTransaction

C#

[SerializableAttribute] 
public sealed class CommittableTransaction
 : Transaction, IAsyncResult

C++

[SerializableAttribute] 
public ref class CommittableTransaction sealed
 : public Transaction, IAsyncResult

J#

/** @attribute SerializableAttribute() */ 
public final class CommittableTransaction extends
 Transaction implements IAsyncResult

JScript

SerializableAttribute 
public final class CommittableTransaction extends
 Transaction implements IAsyncResult

解説

CommittableTransaction クラスは、TransactionScope クラスを暗黙的に使用せずに、アプリケーションでトランザクションを使用する明示的な方法を提供します。TransactionScope クラスとは異なり、アプリケーションの作成者はトランザクションをコミットまたは中止するために、特に Commit メソッドと Rollback メソッドを呼び出す必要があります。ただし、トランザクションをコミットできるのは、そのトランザクションの作成者だけです。したがって、Clone メソッドを介して取得したコミット可能なトランザクションのコピーについてはコミットできません。

メモ
TransactionScope クラスを使用して暗黙のトランザクションを作成し、アンビエント トランザクション コンテキストを自動的に管理することをお勧めします。複数の関数呼び出しまたは複数のスレッド呼び出しで同じトランザクションを使用する必要のあるアプリケーション向けに、TransactionScope クラスおよび DependentTransaction クラスを使用する必要もあります。このモデルの詳細については、「トランザクション スコープを使用した暗黙的なトランザクションの実装」を参照してください。

CommittableTransaction を作成しても、アンビエント トランザクション (コードが実行されるトランザクション) が自動的に設定されるわけではありません。アンビエント トランザクションを取得または設定するには、グローバル オブジェクトである Transaction の静的な Current プロパティを呼び出します。アンビエント トランザクションの詳細については、「トランザクション スコープを使用した暗黙的なトランザクションの実装」で、TransactionScopeOption を使用したトランザクション フローの管理についての説明を参照してください。アンビエント トランザクションが設定されていない場合、そのトランザクションにはリソース マネージャに対するどのような操作も含まれません。リソース マネージャを正しいトランザクション コンテキストに基づいて確実に動作させるには、アンビエント トランザクションを明示的に設定およびリセットする必要があります。

CommittableTransaction がコミットされるまで、トランザクションに関連するすべてのリソースは引き続きロックされます。

CommittableTransaction オブジェクトは再利用できません。このオブジェクトはコミットまたはロールバックされると、トランザクションで使用したり、現在のアンビエント トランザクション コンテキストとして設定したりすることはできません。

使用例

CommittableTransaction の新しいインスタンスを 2 つ作成し、これらのインスタンスをそれぞれコミットおよびロールバックする例を次に示します。

継承階層

System.Object
   System.Transactions.Transaction
    System.Transactions.CommittableTransaction

スレッド セーフ

この型は、マルチスレッド操作に対して安全です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
CommittableTransaction メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装
CommittableTransaction を使用した明示的なトランザクションの実装