Share via


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 屬性以及 IsFirstInTransactionIsLastInTransaction 屬性來驗證交易界限。

適用於

另請參閱