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 свойство, чтобы убедиться, что сообщение было первым сообщением, отправленным в одной транзакции в одну очередь.
Это свойство доступно только в message Queuing версии 2.0 и более поздних версиях.
Чтобы проверить границы транзакций IsFirstInTransaction , можно использовать свойство вместе с двумя другими свойствами: IsLastInTransaction и TransactionId. Используйте первый, чтобы проверить, было ли сообщение последним сообщением, отправленным в транзакции, и используйте последний для получения идентификатора транзакции.
Если в транзакции отправляется только одно сообщение, IsFirstInTransaction для обоих IsLastInTransaction свойств задано значение true
.