Прочитать на английском

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


Message.IsFirstInTransaction Свойство

Определение

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

[System.Messaging.MessagingDescription("MsgIsFirstInTransaction")]
public bool IsFirstInTransaction { get; }

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

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

Атрибуты

Исключения

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

-или-

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

Примеры

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

Комментарии

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

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

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

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

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

Продукт Версии
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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