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 20} からやり直されるため、トランザクション識別子は一意であるとは限りません。 メッセージ キューでは、後続のトランザクションのトランザクション シーケンス番号が異なることがあります。

プロパティを TransactionId および IsLastInTransaction プロパティと共にIsFirstInTransaction使用して、トランザクションの境界を確認できます。

こちらもご覧ください

• IsFirstInTransaction
• IsLastInTransaction
• Transactional