Message.TransactionId 属性

定义

获取曾包含消息的事务的标识符。

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

属性值

与消息关联的事务的标识符。

属性

例外

消息尚未发送。 该属性只能在从队列中检索的消息上读取。

- 或 -

消息队列经过筛选后忽略了 TransactionId 属性。

示例

下面的代码示例显示消息的 TransactionId 属性的值。

注解

接收应用程序使用 TransactionId 属性来验证消息是否作为特定事务的一部分发送。 事务标识符包含发送计算机的标识符 (前 16 位) 后跟 4 字节事务序列号。

此属性仅适用于消息队列 2.0 及更高版本。

不保证事务标识符是唯一的,因为事务序列号不是永久性的,它们从 2 20 重新开始。 消息队列仅保证后续事务将具有不同的事务序列号。

可以将 TransactionId 属性与 和 IsLastInTransaction 属性一起使用IsFirstInTransaction来验证事务边界。

适用于

另请参阅