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

継承階層

System.Object
System.Transactions.Enlistment
System.Transactions.PreparingEnlistment

スレッドセーフ

この型は、マルチスレッド操作に対して安全です。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PreparingEnlistment メンバ
System.Transactions 名前空間
その他の技術情報
単一フェーズおよびマルチフェーズでのトランザクションのコミット

PreparingEnlistment メソッド

パブリックメソッドパブリックメソッド

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

	名前	説明
	Done	トランザクション参加要素が作業を完了したことを示します。 ( Enlistment から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	ForceRollback	オーバーロードされます。トランザクションをロールバックする必要があることを示します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Prepared	トランザクションをコミットできることを示します。
	RecoveryInformation	参加リストの修復情報を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

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

参照

その他の技術情報

単一フェーズおよびマルチフェーズでのトランザクションのコミット

PreparingEnlistment メンバ

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

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

パブリックメソッド

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

	名前	説明
	Done	トランザクション参加要素が作業を完了したことを示します。 (Enlistment から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	ForceRollback	オーバーロードされます。トランザクションをロールバックする必要があることを示します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Prepared	トランザクションをコミットできることを示します。
	RecoveryInformation	参加リストの修復情報を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

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