MessagePropertyFilter.TransactionId Property

public:
 property bool TransactionId { bool get(); void set(bool value); };

[System.Messaging.MessagingDescription("MsgTransactionId")]
public bool TransactionId { get; set; }

[<System.Messaging.MessagingDescription("MsgTransactionId")>]
member this.TransactionId : bool with get, set

Public Property TransactionId As Boolean

Property Value

true to receive TransactionId information; otherwise, false. The default is false.

Attributes

MessagingDescriptionAttribute

Examples

The following code example demonstrates the use of the TransactionId property.

// Set the queue's MessageReadPropertyFilter property 
// to enable the message's TransactionId property.
queue->MessageReadPropertyFilter->TransactionId = true;

// Peek at the message. Time out after ten seconds 
// in case the message was not delivered.
orderMessage = queue->Peek(TimeSpan::FromSeconds(10.0));

// Display the value of the message's 
// TransactionId property.
Console::WriteLine("Message.TransactionId: {0}", 
    orderMessage->TransactionId);

// Set the queue's MessageReadPropertyFilter property to enable the
// message's TransactionId property.
queue.MessageReadPropertyFilter.TransactionId = true;

// Peek at the message. Time out after ten seconds in case the message
// was not delivered.
orderMessage = queue.Peek(TimeSpan.FromSeconds(10.0));

// Display the value of the message's TransactionId property.
Console.WriteLine("Message.TransactionId: {0}",
    orderMessage.TransactionId);

Remarks

The TransactionId property of the Message class identifies the transaction that sent the message. Use this property within a receiving application to verify that a message was sent as part of a specific transaction.

Applies to

See also

• TransactionId
• IsFirstInTransaction
• IsLastInTransaction
• MessageQueue