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


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

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

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