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

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

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

Message.TransactionId プロパティ

一部にメッセージを含むトランザクションの ID を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 TransactionId As String

Visual Basic (使用法)

Dim instance As Message
Dim value As String

value = instance.TransactionId

public string TransactionId { get;
 }

C++

public:
property String^ TransactionId {
    String^ get ();
}

/** @property */
public String get_TransactionId ()

JScript

public function get TransactionId
 () : String

プロパティ値
メッセージに関連付けられているトランザクションの ID。

例外

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

例外の種類

条件

InvalidOperationException

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

または

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

解説

受信側アプリケーションは、メッセージが特定のトランザクションの一部として送信されたかどうかを確認するために TransactionId プロパティを使います。トランザクション ID は、送信元コンピュータの ID (最初の 16 ビット) と、それに続く 4 バイトのトランザクションシーケンス番号で構成されます。

このプロパティは、メッセージキュー Version 2.0 以降でだけ使用できます。

トランザクションシーケンス番号は永続的ではなく、2²⁰ を超えると再び最初から割り当てられるため、トランザクション ID が一意であるという保証はありません。メッセージキューが保証することは、続いて発生するトランザクションの番号を異なるシーケンス番号にすることだけです。

トランザクションの境界を確認するために TransactionId プロパティと共に使用できるプロパティは、IsFirstInTransaction と IsLastInTransaction です。

使用例

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

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

C++

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

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