Message.TransactionId Свойство

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Получает идентификатор транзакции, частью которой является данное сообщение.

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

Значение свойства

String

Идентификатор транзакции, связанной с данным сообщением.

Атрибуты

MessagingDescriptionAttribute

Исключения

InvalidOperationException

Сообщение не отправлено. Это свойство можно прочитать только для сообщений, извлеченных из очереди.

-или-

Очередь сообщений фильтруется, чтобы не учитывать свойство TransactionId.

Примеры

В следующем примере кода отображается значение свойства сообщения TransactionId .

Комментарии

Получающие приложения используют TransactionId свойство , чтобы убедиться, что сообщение было отправлено в рамках определенной транзакции. Идентификатор транзакции содержит идентификатор компьютера-отправителя (первые 16 бит), за которым следует 4-байтовый порядковый номер транзакции.

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

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

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

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

• IsFirstInTransaction
• IsLastInTransaction
• Transactional