Message.IsFirstInTransaction Свойство

Определение

Возвращает значение, указывающее, было ли сообщение первым сообщением, отправленным в транзакцию.

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

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

true Значение , если сообщение было первым сообщением, отправленным в транзакции; falseв противном случае .

Атрибуты

Исключения

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

–или–

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

Примеры

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

Комментарии

Получение приложений использует IsFirstInTransaction свойство для проверки того, что сообщение было первым сообщением, отправленным в одной транзакции в одну очередь.

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

Чтобы проверить границы транзакций IsFirstInTransaction , можно использовать свойство вместе с двумя другими свойствами: IsLastInTransaction и TransactionId. Используйте первый, чтобы проверить, было ли сообщение последним сообщением, отправленным в транзакции, и используйте последний для получения идентификатора транзакции.

Если в транзакции отправляется только одно сообщение, IsFirstInTransaction для обоих IsLastInTransaction свойств задано значение true.

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

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