Message.TransactionStatusQueue プロパティとは何？わかりやすく解説 Weblio辞書

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

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

Message.TransactionStatusQueue プロパティ

送信元コンピュータ上のトランザクションステータスキューを取得します。

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

Visual Basic (宣言)

Public Property TransactionStatusQueue As
 MessageQueue

Visual Basic (使用法)

Dim instance As Message
Dim value As MessageQueue

value = instance.TransactionStatusQueue

instance.TransactionStatusQueue = value

public MessageQueue TransactionStatusQueue { get;
 set; }

C++

public:
property MessageQueue^ TransactionStatusQueue {
    MessageQueue^ get ();
    void set (MessageQueue^ value);
}

/** @property */
public MessageQueue get_TransactionStatusQueue ()

/** @property */
public void set_TransactionStatusQueue (MessageQueue
 value)

JScript

public function get TransactionStatusQueue
 () : MessageQueue

public function set TransactionStatusQueue
 (value : MessageQueue)

プロパティ値
送信元コンピュータ上のトランザクションステータスキュー。送信元アプリケーションに受信確認メッセージを返すときに使われます。既定値は null 参照 (Visual Basic では Nothing) です。

例外

例外の種類	条件
InvalidOperationException	メッセージは送信されていません。このプロパティは、キューから取得したメッセージでだけ読み込むことができます。またはフィルタ処理されたメッセージキューが、TransactionStatusQueue プロパティを無視します。

例外の種類

条件

InvalidOperationException

メッセージは送信されていません。このプロパティは、キューから取得したメッセージでだけ読み込むことができます。

または

フィルタ処理されたメッセージキューが、TransactionStatusQueue プロパティを無視します。

解説

TransactionStatusQueue プロパティは、コネクタアプリケーションから読み取り/取得受信確認を受け取る送信元コンピュータ上のトランザクションキューを識別します。このプロパティはメッセージキューが設定し、コネクタアプリケーションは外部キューに送信されたトランザクションメッセージを取得するときにこのプロパティを使います。

Microsoft メッセージキュー以外のキューシステムに外部キューが存在します。メッセージキューは、コネクタアプリケーションを通じて外部キューと通信します。

コネクタアプリケーションは、トランザクションステータスキューを使って送信元アプリケーションに受信確認メッセージを返すことができます。トランザクションステータスキューは、送信元アプリケーションが別の受信確認を要求しない場合にもこれらの受信確認を受け取ります。

使用例

メッセージの TransactionStatusQueue プロパティの値を表示するコード例を次に示します。

// Display the value of the message's TransactionStatusQueue property.
// To view this property value, the queue's
// MessageReadPropertyFilter.TransactionStatusQueue property must be
// set to true before the message is received.
Console.WriteLine("Message.TransactionStatusQueue.QueueName: {0}",
    orderMessage.TransactionStatusQueue.QueueName);

C++

// Display the value of the message's TransactionStatusQueue property.
// To view this property value, the queue's
// MessageReadPropertyFilter.TransactionStatusQueue property must be
// set to true before the message is received.
Console::WriteLine("Message.TransactionStatusQueue.QueueName: {0}",
    orderMessage->TransactionStatusQueue->QueueName);

// Display the value of the message's TransactionStatusQueue property.
// To view this property value, the queue's
// MessageReadPropertyFilter.TransactionStatusQueue property must be
// set to true before the message is received.
Console.WriteLine("Message.TransactionStatusQueue.QueueName: {0}", 
    orderMessage.get_TransactionStatusQueue().get_QueueName());