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.