Message.IsLastInTransaction Property

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Gets a value that indicates whether the message was the last message sent in a transaction.

C#

[System.Messaging.MessagingDescription("MsgIsLastInTransaction")]
public bool IsLastInTransaction { get; }

Property Value

Boolean

true if the message was the last message sent in a single transaction; otherwise, false.

Attributes

MessagingDescriptionAttribute

Exceptions

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 IsLastInTransaction property.

Examples

The following code example displays the value of a message's IsLastInTransaction property.

Remarks

Receiving applications use the IsLastInTransaction property to verify that a message was the last 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 IsLastInTransaction property along with two other properties: IsFirstInTransaction and TransactionId. Use the former to check whether a message was the first 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.

Applies to

See also

• IsFirstInTransaction
• TransactionId
• Transactional