MessageQueueTransaction クラス

  • リファレンス

定義

名前空間:
System.Messaging
アセンブリ:
System.Messaging.dll

メッセージ キューの内部トランザクションを提供します。

public ref class MessageQueueTransaction : IDisposable
public class MessageQueueTransaction : IDisposable
type MessageQueueTransaction = class
    interface IDisposable
Public Class MessageQueueTransaction
Implements IDisposable
継承
Object
MessageQueueTransaction
実装
IDisposable

注釈

トランザクションの一部としてメッセージを送受信するには、 クラスをMessageQueueTransaction使用してトランザクションを作成し、パラメーターを受け取る transaction メソッドまたは MessageQueue.Receive メソッドのMessageQueue.Sendオーバーロードに渡すことができます。 トランザクションの一部として送信されるメッセージは、トランザクション キューに送信する必要があります。 トランザクション キューから受信したメッセージは、指定したトランザクションを使用して受信する必要があります。

メソッドに Receive 加えて、指定した識別子または指定された関連付け識別子を持つメッセージを受信できます。 トランザクション キューからメッセージを ReceiveById 選択的に受信する方法の詳細については、 メソッドと ReceiveByCorrelationId メソッドを参照してください。

トランザクション キューに送信されたメッセージは、トランザクションがコミットされると削除されます。 同様に、トランザクション キューから受信したメッセージは、トランザクションがロールバックされた場合にキューに返されます。

をインスタンス化MessageQueueTransactionし、それをメソッドまたはReceiveメソッドのSend適用可能なオーバーロードに渡して、非トランザクション キューにメッセージを送信するか、トランザクション以外のキューからメッセージを受信すると、メソッドは "間違ったトランザクション使用量" を示す例外をスローします。

MessageQueueTransaction はスレッド アパートメント対応であるため、アパートメントの状態が の場合、 STA複数のスレッドでトランザクションを使用することはできません。 Visual Basic では、メイン スレッドの状態が にSTA設定されるため、 サブルーチンで をMTAThreadAttribute適用するMain必要があります。 適用しない場合、別のスレッドを使用してトランザクション メッセージを送信すると、MessageQueueException 例外がスローされます。 を適用する場合は MTAThreadAttribute 、次のフラグメントを使用します。

<System.MTAThreadAttribute>  
 public sub Main()

コンストラクター

MessageQueueTransaction()

MessageQueueTransaction クラスの新しいインスタンスを初期化します。

プロパティ

Status

トランザクションのステータスを取得します。

メソッド

Abort()

保留中の内部トランザクションをロールバックします。
Begin()

新しいメッセージ キューの内部トランザクションを開始します。
Commit()

保留中の内部トランザクションをコミットします。
Dispose()

MessageQueueTransaction によって使用されているすべてのリソースを解放します。
Dispose(Boolean)

MessageQueueTransaction によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
Finalize()

現在のインスタンスに保持されているリソースを解放します。
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

適用対象

スレッド セーフ

この型はスレッド セーフです。

こちらもご覧ください