CommittableTransaction.Commit メソッド

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

CommittableTransaction.Commit メソッド

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

トランザクションをコミットしようとします。

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

Visual Basic (宣言)

Public Sub Commit

Visual Basic (使用法)

Dim instance As CommittableTransaction

instance.Commit

C#

public void Commit ()

C++

public:
void Commit ()

J#

public void Commit ()

JScript

public function Commit ()

例外

例外の種類	条件
TransactionInDoubtException	トランザクションで Commit が呼び出され、トランザクションが InDoubt の状態になります。
TransactionAbortedException	Commit が呼び出され、トランザクションが初めてロールバックされます。

解説

このメソッドが呼び出されると、トランザクションに参加するように登録されているすべてのオブジェクトがポーリングされ、トランザクションをコミットするかロールバックするかの決定が個別に示されます。いずれかの参加要素がトランザクションのロールバックを決定した場合、トランザクションがロールバックされ、このメソッドが TransactionException 例外をスローします。これはトランザクションに対する通常の動作であり、このような例外はコードでキャッチして処理する必要があります。

このメソッドは同期的に動作し、トランザクションがコミットまたは中止されるまでブロックします。そのため、このメソッドを Windows フォーム (WinForm) アプリケーションで使用する場合は、デッドロックの発生に十分な注意が必要です。WinForm コントロール イベント (ボタン クリックなど) でこのメソッドを呼び出し、トランザクションの処理中に同期メソッド Invoke を使用して、制御をなんらかの UI タスク (色の変更など) にリダイレクトした場合、デッドロックが発生します。これは、Invoke メソッドが同期的に動作し、UI スレッドが処理を終えるまでワーカー スレッドがブロックされるためです。また、この場合、UI スレッド側も、ワーカー スレッドがトランザクションのコミットを完了するまで待機しようとします。その結果、いずれも処理を行うことができず、決して終わることのないコミット処理を無期限に待機することとなってしまいます。このため、できるだけ Invoke は使わずに、非同期で動作する BeginInvoke を使用することをお勧めします。こうすることで、デッドロックの発生を抑えることができます。

プラットフォーム

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 クラス
CommittableTransaction メンバ
System.Transactions 名前空間