Message.TransactionId Свойство

Определение

Получает идентификатор транзакции, частью которой является данное сообщение.Gets the identifier for the transaction of which the message was a part.

public:
 property System::String ^ TransactionId { System::String ^ get(); };
[System.Messaging.MessagingDescription("MsgTransactionId")]
public string TransactionId { get; }
member this.TransactionId : string
Public ReadOnly Property TransactionId As String

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

Идентификатор транзакции, связанной с данным сообщением.The identifier for the transaction associated with the message.

Атрибуты

Исключения

Сообщение не отправлено.The message has not been sent. Это свойство можно прочитать только для сообщений, извлеченных из очереди.This property can only be read on messages retrieved from a queue.

- или --or- Очередь сообщений фильтруется, чтобы не учитывать свойство TransactionId.The message queue is filtered to ignore the TransactionId property.

Примеры

В следующем примере кода выводится значение TransactionId свойства сообщения.The following code example displays the value of a message's TransactionId property.

Комментарии

Принимающие приложения используют TransactionId свойство для проверки того, что сообщение было отправлено как часть определенной транзакции.Receiving applications use the TransactionId property to verify that a message was sent as part of a specific transaction. Идентификатор транзакции содержит идентификатор отправляющего компьютера (первые 16 бит), за которым следует 4-байтовый порядковый номер транзакции.The transaction identifier contains the identifier of the sending computer (first 16 bits) followed by a 4-byte transaction sequence number.

Это свойство доступно только для очереди сообщений версии 2,0 и более поздних версий.This property is available only for Message Queuing version 2.0 and later.

Идентификаторы транзакций не обязательно должны быть уникальными, так как порядковые номера транзакций не являются постоянными и снова начинаются с 2 20.Transaction identifiers are not guaranteed to be unique, because transaction sequence numbers are not persistent, and they start over again at 2 20. Очередь сообщений гарантирует, что только последующие транзакции будут иметь разные порядковые номера транзакций.Message Queuing guarantees only that subsequent transactions will have different transaction sequence numbers.

Для проверки границ транзакций TransactionId можно использовать свойство вместе IsFirstInTransaction со IsLastInTransaction свойствами и.You can use the TransactionId property along with the IsFirstInTransaction and IsLastInTransaction properties to verify transaction boundaries.

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

Дополнительно