Message.TransactionId プロパティ

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

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

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

[System.Messaging.MessagingDescription("MsgTransactionId")]
public string TransactionId { get; }

[<System.Messaging.MessagingDescription("MsgTransactionId")>]
member this.TransactionId : string

Public ReadOnly Property TransactionId As String

プロパティ値

String

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

属性

MessagingDescriptionAttribute

例外

InvalidOperationException

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

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

例

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

注釈

受信アプリケーションでは、このプロパティを TransactionId 使用して、メッセージが特定のトランザクションの一部として送信されたことを確認します。 トランザクション識別子には、送信側コンピューターの識別子 (最初の 16 ビット) の後に 4 バイトのトランザクション シーケンス番号が続きます。

このプロパティは、メッセージ キュー バージョン 2.0 以降でのみ使用できます。

トランザクションシーケンス番号は永続的ではなく、2 ²⁰ でやり直されるため、トランザクション識別子は一意であるとは限りません。 メッセージ キューでは、後続のトランザクションのトランザクション シーケンス番号が異なっていることのみが保証されます。

プロパティとプロパティをTransactionId使用して、トランザクションのIsLastInTransactionIsFirstInTransaction境界を確認できます。

こちらもご覧ください

• IsFirstInTransaction
• IsLastInTransaction
• Transactional