Message::IsFirstInTransaction Property
Gets a value that indicates whether the message was the first message sent in a transaction.
Assembly: System.Messaging (in System.Messaging.dll)
public: [MessagingDescriptionAttribute("MsgIsFirstInTransaction")] property bool IsFirstInTransaction { bool get(); }
Property Value
Type: System::Booleantrue if the message was the first message sent in a transaction; otherwise, false.
| Exception | Condition |
|---|---|
| InvalidOperationException | The message has not been sent. This property can only be read on messages retrieved from a queue. -or- The message queue is filtered to ignore the IsFirstInTransaction property. |
Receiving applications use the IsFirstInTransaction property to verify that a message was the first message sent in a single transaction to a single queue.
This property is available only with Message Queuing version 2.0 and later.
To verify transaction boundaries, you can use the IsFirstInTransaction property along with two other properties: IsLastInTransaction and TransactionId. Use the former to check whether a message was the last message sent in the transaction, and use the latter to retrieve the identifier of the transaction.
If only one message is sent in a transaction, the IsFirstInTransaction and IsLastInTransaction properties are both set to true.
The following code example displays the value of a message's IsFirstInTransaction property.
Available since 1.1