Поделиться через


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-байтовый порядковый номер транзакции.

Это свойство доступно только для Message Queuing версии 2.0 и более поздних версий.

Идентификаторы транзакций не гарантируются как уникальные, так как порядковые номера транзакций не являются постоянными и начинаются заново с 2 20. Очередь сообщений гарантирует только то, что последующие транзакции будут иметь разные порядковые номера транзакций.

Для проверки границ транзакций TransactionId можно использовать свойство вместе со IsFirstInTransaction свойствами и IsLastInTransaction .

Применяется к

См. также раздел