Message.TransactionStatusQueue プロパティ

.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

C#

public MessageQueue TransactionStatusQueue { get;
 set; }

C++

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

J#

/** @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 プロパティを無視します。

解説

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

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

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

使用例

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

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

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

J#

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
Message.TransactionId プロパティ
Message.AdministrationQueue プロパティ
Message.DestinationQueue プロパティ
Message.ResponseQueue プロパティ
Transactional
AcknowledgeTypes 列挙体