Enlistment Enlistment Enlistment Enlistment Class

定義

トランザクションの最終フェーズにおいて、トランザクションに参加している参加要素とトランザクション マネージャーの間の通信を容易にします。Facilitates communication between an enlisted transaction participant and the transaction manager during the final phase of the transaction.

public ref class Enlistment
public class Enlistment
type Enlistment = class
Public Class Enlistment
継承
EnlistmentEnlistmentEnlistmentEnlistment
派生

次の例の実装を示しています、IEnlistmentNotificationインターフェイスとタイミング、Doneメソッドを呼び出す必要があります。The following example shows an implementation of the IEnlistmentNotification interface, and when the Done method should be called.

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

注釈

ときに、EnlistVolatileEnlistDurableのメソッド、Transactionオブジェクトが起動され、トランザクションの参加者の参加、参加リストを記述するこのオブジェクトを返します。When the EnlistVolatile and EnlistDurable methods of the Transaction object are invoked to enlist a participant in a transaction, they return this object describing the enlistment.

トランザクションのコミットの最終フェーズでは、トランザクション マネージャーが実装するリソース マネージャーにこのオブジェクトを渡します、IEnlistmentNotificationトランザクションに参加しているインターフェイス。During the final phase of the transaction commit, the transaction manager passes this object to a resource manager implementing the IEnlistmentNotification interface that has enlisted in a transaction. 具体的には、トランザクション マネージャーを呼び出すか、CommitまたはRollbackかどうか、後者はことに決めましたコミットまたはトランザクションのロールバックによって、参加要素のメソッド。Specifically, the transaction manager calls either the Commit or the Rollback method of the participant, depending on whether the latter has decided to commit or roll back the transaction. 参加者が呼び出す必要があります、Doneトランザクション マネージャーがその作業が完了したことを把握できるようにするには、このオブジェクトのメソッド。The participant should call the Done method of this object to let the transaction manager know that it has completed its work.

参加リストが呼び出すことができます、Doneでいつでも前にメソッドが呼び出されますがPrepared準備フェーズでします。An enlistment can call the Done method at anytime before it has called Prepared in the prepare phase. これにより、参加リスト投票のトランザクションのコミットが、最終結果を受信する必要はありません、つまり読み取り専用の決定をキャストします。By doing so, the enlistment is casting a read only vote, meaning that it votes commit on the transaction but does not need to receive the final outcome. その後に注意してください、Doneメソッドが呼び出されると、参加要素をトランザクション マネージャーからさらに通知受信しません。Note that, after the Done method is called, the enlisted participant receives no further notifications from the transaction manager.

メソッド

Done() Done() Done() Done()

トランザクション参加要素が作業を完了したことを示します。Indicates that the transaction participant has completed its work.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

スレッド セーフ

この型はスレッド セーフです。This type is thread safe.

こちらもご覧ください