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 : stringPublic ReadOnly Property TransactionId As StringЗначение свойства
Идентификатор транзакции, связанной с данным сообщением.
- Атрибуты
Исключения
Сообщение не отправлено. Это свойство можно прочитать только для сообщений, извлеченных из очереди.
-или-
Очередь сообщений фильтруется, чтобы не учитывать свойство TransactionId.
Примеры
В следующем примере кода отображается значение свойства сообщения TransactionId .
Комментарии
Получающие приложения используют TransactionId свойство , чтобы убедиться, что сообщение было отправлено в рамках определенной транзакции. Идентификатор транзакции содержит идентификатор компьютера-отправителя (первые 16 бит), за которым следует 4-байтовый порядковый номер транзакции.
Это свойство доступно только для Message Queuing версии 2.0 и более поздних версий.
Идентификаторы транзакций не гарантируются как уникальные, так как порядковые номера транзакций не являются постоянными и начинаются заново с 2 20. Очередь сообщений гарантирует только то, что последующие транзакции будут иметь разные порядковые номера транзакций.
Для проверки границ транзакций TransactionId можно использовать свойство вместе со IsFirstInTransaction свойствами и IsLastInTransaction .
