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