CommittableTransaction

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

CommittableTransaction イベント

パブリック イベント

	名前	説明
	TransactionCompleted	トランザクションが完了したことを示します。 ( Transaction から継承されます。)

参照

関連項目

CommittableTransaction クラス
System.Transactions 名前空間

その他の技術情報

トランザクション スコープを使用した暗黙的なトランザクションの実装
CommittableTransaction を使用した明示的なトランザクションの実装

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 を使用した明示的なトランザクションの実装

CommittableTransaction コンストラクタ ()

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

CommittableTransaction クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New CommittableTransaction

C#

public CommittableTransaction ()

C++

public:
CommittableTransaction ()

J#

public CommittableTransaction ()

JScript

public function CommittableTransaction ()

例外

例外の種類	条件
PlatformNotSupportedException	Windows 98、Windows 98 Second Edition、または Windows Millennium Edition でトランザクションを作成しようとしました。

使用例

CommittableTransaction の新しいインスタンスを作成してコミットする例を次に示します。

Visual Basic

tx = New CommittableTransaction

Dim myConnection As New
 SqlConnection("server=(local)\SQLExpress;Integrated Security=SSPI;database=northwind")
Dim myCommand As New SqlCommand()

'Open the SQL connection
myConnection.Open()

'Give the transaction to SQL to enlist with
myConnection.EnlistTransaction(tx)

myCommand.Connection = myConnection

'Restore database to near it's original condition so sample will work
 correctly.
myCommand.CommandText = "DELETE FROM Region WHERE (RegionID =
 100) OR (RegionID = 101)"
myCommand.ExecuteNonQuery()

'Insert the first record.
myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES
 (100, 'MidWestern')"
myCommand.ExecuteNonQuery()

'Insert the second record.
myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES
 (101, 'MidEastern')"
myCommand.ExecuteNonQuery()

'Commit or rollback the transaction
Dim c As ConsoleKeyInfo
While (True)
    Console.Write("Commit or Rollback? [C|R] ")
    c = Console.ReadKey()
    Console.WriteLine()

    If (c.KeyChar = "C") Or
 (c.KeyChar = "c") Then
        tx.Commit()
        Exit While
    ElseIf ((c.KeyChar = "R") Or
 (c.KeyChar = "r")) Then
        tx.Rollback()
        Exit While
    End If
End While

myConnection.Close()
tx = Nothing

C#

//Create a committable transaction
tx = new CommittableTransaction();

SqlConnection myConnection = new SqlConnection("server=(local)\\SQLExpress;Integrated
 Security=SSPI;database=northwind");
SqlCommand myCommand = new SqlCommand();

//Open the SQL connection
myConnection.Open();

//Give the transaction to SQL to enlist with
myConnection.EnlistTransaction(tx);

myCommand.Connection = myConnection;

// Restore database to near it's original condition so sample will work
 correctly.
myCommand.CommandText = "DELETE FROM Region WHERE (RegionID = 100) OR (RegionID
 = 101)";
myCommand.ExecuteNonQuery();

// Insert the first record.
myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES
 (100, 'MidWestern')";
myCommand.ExecuteNonQuery();

// Insert the second record.
myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES
 (101, 'MidEastern')";
myCommand.ExecuteNonQuery();

// Commit or rollback the transaction
while (true)
{
    Console.Write("Commit or Rollback? [C|R] ");
    ConsoleKeyInfo c = Console.ReadKey();
    Console.WriteLine();

    if ((c.KeyChar == 'C') || (c.KeyChar == 'c'))
    {
        tx.Commit();
        break;
    }
    else if ((c.KeyChar == 'R') || (c.KeyChar
 == 'r'))
    {
        tx.Rollback();
        break;
    }
}
myConnection.Close();
tx = null;

プラットフォーム

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 名前空間

CommittableTransaction コンストラクタ (TimeSpan)

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

指定した timeout 値を使用して、CommittableTransaction クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    timeout As TimeSpan _
)

Visual Basic (使用法)

Dim timeout As TimeSpan

Dim instance As New CommittableTransaction(timeout)

C#

public CommittableTransaction (
    TimeSpan timeout
)

C++

public:
CommittableTransaction (
    TimeSpan timeout
)

J#

public CommittableTransaction (
    TimeSpan timeout
)

JScript

public function CommittableTransaction (
    timeout : TimeSpan
)

パラメータ

timeout

トランザクションが中止されるまでに存在できる最大時間。

例外

例外の種類	条件
PlatformNotSupportedException	Windows 98、Windows 98 Second Edition、または Windows Millennium Edition でトランザクションを作成しようとしました。

プラットフォーム

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 名前空間

CommittableTransaction コンストラクタ (TransactionOptions)

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

指定したトランザクション オプションを使用して、CommittableTransaction クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    options As TransactionOptions _
)

Visual Basic (使用法)

Dim options As TransactionOptions

Dim instance As New CommittableTransaction(options)

C#

public CommittableTransaction (
    TransactionOptions options
)

C++

public:
CommittableTransaction (
    TransactionOptions options
)

J#

public CommittableTransaction (
    TransactionOptions options
)

JScript

public function CommittableTransaction (
    options : TransactionOptions
)

パラメータ

options

新しいトランザクションで使用するトランザクション オプションを示す TransactionOptions 構造体。

例外

例外の種類	条件
PlatformNotSupportedException	Windows 98、Windows 98 Second Edition、または Windows Millennium Edition でトランザクションを作成しようとしました。
ArgumentException	options が無効です。

使用例

オプションを指定して 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 クラス
CommittableTransaction メンバ
System.Transactions 名前空間

CommittableTransaction コンストラクタ

CommittableTransaction クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
CommittableTransaction ()	CommittableTransaction クラスの新しいインスタンスを初期化します。
CommittableTransaction (TimeSpan)	指定した timeout 値を使用して、CommittableTransaction クラスの新しいインスタンスを初期化します。
CommittableTransaction (TransactionOptions)	指定したトランザクション オプションを使用して、CommittableTransaction クラスの新しいインスタンスを初期化します。

参照

関連項目

CommittableTransaction クラス
CommittableTransaction メンバ
System.Transactions 名前空間

CommittableTransaction プロパティ

パブリック プロパティ

	名前	説明
	Current	アンビエント トランザクションを取得または設定します。 ( Transaction から継承されます。)
	IsolationLevel	トランザクションの分離レベルを取得します。 ( Transaction から継承されます。)
	TransactionInformation	トランザクションの追加情報を取得します。 ( Transaction から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.IAsyncResult.AsyncState	BeginCommit メソッド呼び出しの最後のパラメータに指定されたオブジェクトを取得します。
	System.IAsyncResult.AsyncWaitHandle	非同期操作が完了するまで待機するために使用する WaitHandle を取得します。
	System.IAsyncResult.CompletedSynchronously	非同期のコミット操作が同期的に完了したかどうかを示す値を取得します。
	System.IAsyncResult.IsCompleted	非同期のコミット操作が完了したかどうかを示す値を取得します。

参照

関連項目

CommittableTransaction クラス
System.Transactions 名前空間

その他の技術情報

トランザクション スコープを使用した暗黙的なトランザクションの実装
CommittableTransaction を使用した明示的なトランザクションの実装

CommittableTransaction メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginCommit	非同期的にトランザクションをコミットする試みを開始します。
	Clone	トランザクションの複製を作成します。 ( Transaction から継承されます。)
	Commit	トランザクションをコミットしようとします。
	DependentClone	トランザクションの依存する複製を作成します。 ( Transaction から継承されます。)
	Dispose	オブジェクトによって保持されているリソースを解放します。 ( Transaction から継承されます。)
	EndCommit	非同期的にトランザクションをコミットする試みを終了します。
	EnlistDurable	オーバーロードされます。 トランザクションに参加する永続的リソース マネージャを参加させます。 ( Transaction から継承されます。)
	EnlistPromotableSinglePhase	PSPE (Promotable Single Phase Enlistment) を使用して、内部トランザクションを持つリソース マネージャを参加させます。 ( Transaction から継承されます。)
	EnlistVolatile	オーバーロードされます。 トランザクションに参加する揮発性リソース マネージャを参加させます。 ( Transaction から継承されます。)
	Equals	オーバーロードされます。 このトランザクションと指定したオブジェクトが等しいかどうかを判断します。 ( Transaction から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 ( Transaction から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	op_Equality	指定した 2 つの Transaction インスタンスが等価であるかどうかをテストします。 ( Transaction から継承されます。)
	op_Inequality	2 つの Transaction インスタンスが等しくないかどうかを示す値を返します。 ( Transaction から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Rollback	オーバーロードされます。 トランザクションをロールバック (中止) します。 ( Transaction から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

CommittableTransaction クラス
System.Transactions 名前空間

その他の技術情報

トランザクション スコープを使用した暗黙的なトランザクションの実装
CommittableTransaction を使用した明示的なトランザクションの実装

CommittableTransaction メンバ

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

CommittableTransaction データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	CommittableTransaction	オーバーロードされます。 CommittableTransaction クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Current	アンビエント トランザクションを取得または設定します。(Transaction から継承されます。)
	IsolationLevel	トランザクションの分離レベルを取得します。(Transaction から継承されます。)
	TransactionInformation	トランザクションの追加情報を取得します。(Transaction から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginCommit	非同期的にトランザクションをコミットする試みを開始します。
	Clone	トランザクションの複製を作成します。 (Transaction から継承されます。)
	Commit	トランザクションをコミットしようとします。
	DependentClone	トランザクションの依存する複製を作成します。 (Transaction から継承されます。)
	Dispose	オブジェクトによって保持されているリソースを解放します。 (Transaction から継承されます。)
	EndCommit	非同期的にトランザクションをコミットする試みを終了します。
	EnlistDurable	オーバーロードされます。 トランザクションに参加する永続的リソース マネージャを参加させます。 (Transaction から継承されます。)
	EnlistPromotableSinglePhase	PSPE (Promotable Single Phase Enlistment) を使用して、内部トランザクションを持つリソース マネージャを参加させます。 (Transaction から継承されます。)
	EnlistVolatile	オーバーロードされます。 トランザクションに参加する揮発性リソース マネージャを参加させます。 (Transaction から継承されます。)
	Equals	オーバーロードされます。 このトランザクションと指定したオブジェクトが等しいかどうかを判断します。 (Transaction から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 (Transaction から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	op_Equality	指定した 2 つの Transaction インスタンスが等価であるかどうかをテストします。 (Transaction から継承されます。)
	op_Inequality	2 つの Transaction インスタンスが等しくないかどうかを示す値を返します。 (Transaction から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Rollback	オーバーロードされます。 トランザクションをロールバック (中止) します。 (Transaction から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

パブリック イベント

	名前	説明
	TransactionCompleted	トランザクションが完了したことを示します。(Transaction から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.IAsyncResult.AsyncState	BeginCommit メソッド呼び出しの最後のパラメータに指定されたオブジェクトを取得します。
	System.IAsyncResult.AsyncWaitHandle	非同期操作が完了するまで待機するために使用する WaitHandle を取得します。
	System.IAsyncResult.CompletedSynchronously	非同期のコミット操作が同期的に完了したかどうかを示す値を取得します。
	System.IAsyncResult.IsCompleted	非同期のコミット操作が完了したかどうかを示す値を取得します。

参照

関連項目

CommittableTransaction クラス
System.Transactions 名前空間

その他の技術情報

トランザクション スコープを使用した暗黙的なトランザクションの実装
CommittableTransaction を使用した明示的なトランザクションの実装