PreparingEnlistment クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

PreparingEnlistment クラス

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

トランザクションの準備フェーズにおいて、参加するトランザクションの参加要素とトランザクションマネージャの間の通信を容易にします。

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

Visual Basic (宣言)

Public Class PreparingEnlistment
    Inherits Enlistment

Visual Basic (使用法)

Dim instance As PreparingEnlistment

public class PreparingEnlistment : Enlistment

C++

public ref class PreparingEnlistment : public
 Enlistment

public class PreparingEnlistment extends Enlistment

JScript

public class PreparingEnlistment extends
 Enlistment

解説

トランザクションの初期 (準備) フェーズにおいて、トランザクションマネージャは、Prepare メソッドを呼び出して、この型をリソースマネージャに渡し、そのトランザクションに関するリソースの決定を取得します。コミットするかロールバックするかの決定に基づいて、リソースマネージャの実装は、この型の Prepared メソッドまたは ForceRollback メソッドを呼び出します。

また、リソースマネージャは、Prepared メソッドを呼び出す前に、いつでも Done メソッドを呼び出すことができます。これにより、参加リストは読み取り専用の決定をキャストします。これは、トランザクションはコミットするが、最終結果を受け取る必要がないことを意味します。

永続的リソースマネージャは、トランザクションマネージャが参加リストを再作成するために必要な情報を RecoveryInformation プロパティから取得できます。回復の詳細については、「回復の実行」を参照してください。

使用例

Visual Basic

Public Class EnlistmentClass
    Implements IEnlistmentNotification

    Public Sub Prepare(ByVal
 myPreparingEnlistment As PreparingEnlistment) Implements
 System.Transactions.IEnlistmentNotification.Prepare
        Console.WriteLine("Prepare notification received")

        'Perform transactional work

        'If work finished correctly, reply with prepared
        myPreparingEnlistment.Prepared()
    End Sub

    Public Sub Commit(ByVal
 myEnlistment As Enlistment) Implements System.Transactions.IEnlistmentNotification.Commit
        Console.WriteLine("Commit notification received")

        'Do any work necessary when commit notification is received

        'Declare done on the enlistment
        myEnlistment.Done()
    End Sub

    Public Sub Rollback(ByVal
 myEnlistment As Enlistment) Implements System.Transactions.IEnlistmentNotification.Rollback
        Console.WriteLine("Rollback notification received")

        'Do any work necessary when rollback notification is received

        'Declare done on the enlistment
        myEnlistment.Done()
    End Sub

    Public Sub InDoubt(ByVal
 myEnlistment As Enlistment) Implements System.Transactions.IEnlistmentNotification.InDoubt
        Console.WriteLine("In doubt notification received")

        'Do any work necessary when indout notification is received

        'Declare done on the enlistment
        myEnlistment.Done()
    End Sub
End Class

class myEnlistmentClass : IEnlistmentNotification
{
    public void Prepare(PreparingEnlistment
 preparingEnlistment)
    {
        Console.WriteLine("Prepare notification received");

        //Perform transactional work

        //If work finished correctly, reply prepared
        preparingEnlistment.Prepared();

        // otherwise, do a ForceRollback
        preparingEnlistment.ForceRollback();
    }

    public void Commit(Enlistment enlistment)
    {
        Console.WriteLine("Commit notification received");

        //Do any work necessary when commit notification is received

        //Declare done on the enlistment
        enlistment.Done();
    }

    public void Rollback(Enlistment enlistment)
    {
        Console.WriteLine("Rollback notification received");

        //Do any work necessary when rollback notification is received

        //Declare done on the enlistment
        enlistment.Done();
    }

    public void InDoubt(Enlistment enlistment)
    {
        Console.WriteLine("In doubt notification received");

        //Do any work necessary when indout notification is received
        
        //Declare done on the enlistment
        enlistment.Done();
    }
}