DependentTransaction クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
トランザクションの作業に関してアプリケーションが停止するまで、トランザクションをコミットできないようにする、トランザクションの複製を記述します。 このクラスは継承できません。
public ref class DependentTransaction sealed : System::Transactions::Transactionpublic ref class DependentTransaction sealed : System::Transactions::Transaction, System::Runtime::Serialization::ISerializablepublic sealed class DependentTransaction : System.Transactions.Transaction[System.Serializable]
public sealed class DependentTransaction : System.Transactions.Transaction[System.Serializable]
public sealed class DependentTransaction : System.Transactions.Transaction, System.Runtime.Serialization.ISerializabletype DependentTransaction = class
inherit Transaction[<System.Serializable>]
type DependentTransaction = class
inherit Transaction[<System.Serializable>]
type DependentTransaction = class
inherit Transaction
interface ISerializablePublic NotInheritable Class DependentTransaction
Inherits TransactionPublic NotInheritable Class DependentTransaction
Inherits Transaction
Implements ISerializable- 継承
- 属性
- 実装
例
次の例は、依存トランザクションを作成する方法を示しています。
static void Main(string[] args)
{
try
{
using (TransactionScope scope = new TransactionScope())
{
// Perform transactional work here.
//Queue work item
ThreadPool.QueueUserWorkItem(new WaitCallback(WorkerThread), Transaction.Current.DependentClone(DependentCloneOption.BlockCommitUntilComplete));
//Display transaction information
Console.WriteLine("Transaction information:");
Console.WriteLine("ID: {0}", Transaction.Current.TransactionInformation.LocalIdentifier);
Console.WriteLine("status: {0}", Transaction.Current.TransactionInformation.Status);
Console.WriteLine("isolationlevel: {0}", Transaction.Current.IsolationLevel);
//Call Complete on the TransactionScope based on console input
ConsoleKeyInfo c;
while (true)
{
Console.Write("Complete the transaction scope? [Y|N] ");
c = Console.ReadKey();
Console.WriteLine();
if ((c.KeyChar == 'Y') || (c.KeyChar == 'y'))
{
//Call complete on the scope
scope.Complete();
break;
}
else if ((c.KeyChar == 'N') || (c.KeyChar == 'n'))
{
break;
}
}
}
}
catch (System.Transactions.TransactionException ex)
{
Console.WriteLine(ex);
}
catch
{
Console.WriteLine("Cannot complete transaction");
throw;
}
}
private static void WorkerThread(object transaction)
{
//Create a DependentTransaction from the object passed to the WorkerThread
DependentTransaction dTx = (DependentTransaction)transaction;
//Sleep for 1 second to force the worker thread to delay
Thread.Sleep(1000);
//Pass the DependentTransaction to the scope, so that work done in the scope becomes part of the transaction passed to the worker thread
using (TransactionScope ts = new TransactionScope(dTx))
{
//Perform transactional work here.
//Call complete on the transaction scope
ts.Complete();
}
//Call complete on the dependent transaction
dTx.Complete();
}
Public Shared Sub Main()
Try
Using scope As TransactionScope = New TransactionScope()
'Perform transactional work here.
'Queue work item
ThreadPool.QueueUserWorkItem(AddressOf WorkerThread, Transaction.Current.DependentClone(DependentCloneOption.BlockCommitUntilComplete))
'Display transaction information
Console.WriteLine("Transaction information:")
Console.WriteLine("ID: {0}", Transaction.Current.TransactionInformation.LocalIdentifier)
Console.WriteLine("status: {0}", Transaction.Current.TransactionInformation.Status)
Console.WriteLine("isolationlevel: {0}", Transaction.Current.IsolationLevel)
'Call Complete on the TransactionScope based on console input
Dim c As ConsoleKeyInfo
While (True)
Console.Write("Complete the transaction scope? [Y|N] ")
c = Console.ReadKey()
Console.WriteLine()
If (c.KeyChar = "Y") Or (c.KeyChar = "y") Then
scope.Complete()
Exit While
ElseIf ((c.KeyChar = "N") Or (c.KeyChar = "n")) Then
Exit While
End If
End While
End Using
Catch ex As TransactionException
Console.WriteLine(ex)
Catch
Console.WriteLine("Cannot complete transaction")
Throw
End Try
End Sub
Public Shared Sub WorkerThread(ByVal myTransaction As Object)
'Create a DependentTransaction from the object passed to the WorkerThread
Dim dTx As DependentTransaction
dTx = CType(myTransaction, DependentTransaction)
'Sleep for 1 second to force the worker thread to delay
Thread.Sleep(1000)
'Pass the DependentTransaction to the scope, so that work done in the scope becomes part of the transaction passed to the worker thread
Using ts As TransactionScope = New TransactionScope(dTx)
'Perform transactional work here.
'Call complete on the transaction scope
ts.Complete()
End Using
'Call complete on the dependent transaction
dTx.Complete()
End Sub
注釈
これは DependentTransaction 、メソッドを Transaction 使用して作成されたオブジェクトの DependentClone 複製です。 その唯一の目的は、アプリケーションを保存し、トランザクション (たとえば、ワーカー スレッド) で作業が実行されている間にトランザクションがコミットできないことを保証することです。
複製されたトランザクション内で行われた作業が最終的に完了し、コミットする準備ができたら、メソッドを使用してトランザクションの作成者に Complete 通知できます。 したがって、データの一貫性と正確性を維持できます。
列挙型は DependentCloneOption 、コミット時の動作を決定するために使用されます。 この動作制御を使用すると、アプリケーションの保存が可能になるだけでなく、コンカレンシーのサポートも提供されます。 この列挙体の使用方法の詳細については、「 DependentTransaction を使用したコンカレンシーの管理」を参照してください。
プロパティ
| IsolationLevel |
トランザクションの分離レベルを取得します。 (継承元 Transaction) |
| PromoterType |
トランザクションを昇格するときに、Promote メソッドで返される |
| TransactionInformation |
トランザクションの追加情報を取得します。 (継承元 Transaction) |
メソッド
events
| TransactionCompleted |
トランザクションが完了したことを示します。 (継承元 Transaction) |
明示的なインターフェイスの実装
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
SerializationInfo に、オブジェクトをシリアル化するために必要なデータを設定します。 |
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
このトランザクションのシリアル化に必要なデータを含む SerializationInfo を取得します。 (継承元 Transaction) |
適用対象
スレッド セーフ
この型はスレッド セーフです。