Message.IsFirstInTransaction Свойство

Определение

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

System.Messaging

Сборка:

System.Messaging.dll

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

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

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

Boolean

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

Атрибуты

MessagingDescriptionAttribute

Исключения

InvalidOperationException

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

-или-

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

Примеры

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

Комментарии

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

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

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

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

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

• IsLastInTransaction
• TransactionId
• Transactional