Message.IsFirstInTransaction Свойство

Определение

Получает значение, показывающее, является ли это сообщением первым переданным сообщением транзакции.Gets a value that indicates whether the message was the first message sent in a transaction.

public:
 property bool IsFirstInTransaction { bool get(); };
[System.Messaging.MessagingDescription("MsgIsFirstInTransaction")]
public bool IsFirstInTransaction { get; }
member this.IsFirstInTransaction : bool
Public ReadOnly Property IsFirstInTransaction As Boolean

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

Значение true, если данное сообщение было первым сообщением, переданным в транзакции, в противном случае — значение false.true if the message was the first message sent in a transaction; otherwise, false.

Атрибуты

Исключения

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

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

Примеры

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

Комментарии

Принимающие приложения используют IsFirstInTransaction свойство для проверки того, что сообщение было первым сообщением, отправленным в одной транзакции в одну очередь.Receiving applications use the IsFirstInTransaction property to verify that a message was the first message sent in a single transaction to a single queue.

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

Чтобы проверить границы транзакций, можно использовать IsFirstInTransaction свойство вместе с двумя другими свойствами: IsLastInTransaction и TransactionId.To verify transaction boundaries, you can use the IsFirstInTransaction property along with two other properties: IsLastInTransaction and TransactionId. Используйте первый из них, чтобы проверить, было ли сообщение отправлено последним в транзакции, и использовать второй для получения идентификатора транзакции.Use the former to check whether a message was the last message sent in the transaction, and use the latter to retrieve the identifier of the transaction.

Если в транзакции отправляется только одно сообщение, IsFirstInTransaction для trueсвойств и IsLastInTransaction устанавливается значение.If only one message is sent in a transaction, the IsFirstInTransaction and IsLastInTransaction properties are both set to true.

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

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