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

すべての辞書から再検索する

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

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

Enlistment クラス

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

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

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

Visual Basic (宣言)

Public Class Enlistment

Visual Basic (使用法)

Dim instance As Enlistment

public class Enlistment

C++

public ref class Enlistment

public class Enlistment

JScript

public class Enlistment

解説

トランザクションに参加要素を参加させるために Transaction オブジェクトの EnlistVolatile メソッドおよび EnlistDurable メソッドを呼び出すと、参加リストを示すこのオブジェクトが返されます。

トランザクションのコミットの最終フェーズで、トランザクションマネージャは、このオブジェクトをトランザクションに参加している IEnlistmentNotification インターフェイスを実装するリソースマネージャに渡します。特に、トランザクションマネージャは、リソースマネージャがトランザクションのコミットを決定しているか、またはロールバックの実行を決定しているかに基づいて、参加要素の Commit メソッドまたは Rollback メソッドを呼び出します。参加要素は、このオブジェクトの Done メソッドを呼び出して、トランザクションマネージャに作業の完了を通知する必要があります。

参加リストは、準備フェーズで Prepared を呼び出す前に、いつでも Done メソッドを呼び出すことができます。これにより、参加リストは読み取り専用の決定を行います。これは、トランザクションはコミットするが、最終結果を受け取る必要がないことを意味します。Done メソッドの呼び出し後、登録されている参加要素は、トランザクションマネージャからさらに通知を受け取ることはありません。

使用例

IEnlistmentNotification インターフェイスの実装と、Done メソッドを呼び出す必要がある場合を表す例を次に示します。

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();
    }
}