Export (0) Print
Expand All

MessagePropertyFilter.UseTracing Property

Gets or sets a value that indicates whether to retrieve Message.UseTracing property information when receiving or peeking a message.

Namespace:  System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

[MessagingDescriptionAttribute("MsgUseTracing")]
public bool UseTracing { get; set; }

Property Value

Type: System.Boolean
true to receive Message.UseTracing information; otherwise, false. The default is false.

The UseTracing property of the Message class specifies whether to track the route of a message as it moves toward its destination queue. If true, each time the original message passes through a Message Queuing routing server, a Message Queuing-generated report message is sent to the system report queue.

Using tracing involves setting up Active Directory and specifying a report queue for the Message Queuing enterprise. These settings are configured by the administrator.

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

// Set the queue's MessageReadPropertyFilter property to enable the 
// message's UseTracing property.
queue.MessageReadPropertyFilter.UseTracing = 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 UseTracing property.
Console.WriteLine("Message.UseTracing: {0}",
    orderMessage.UseTracing);

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft