Export (0) Print
Expand All

Message.UseTracing Property

Gets or sets a value that indicates whether to trace a message as it moves toward its destination queue.

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

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

Property Value

Type: System.Boolean
true if each intermediate step made by the original message en route to the destination queue generates a report to be sent to the system's report queue; otherwise, false. The default is false.

ExceptionCondition
InvalidOperationException

The message queue is filtered to ignore the UseTracing property.

The UseTracing property specifies whether to track the route of a message as it moves toward its destination queue. If true, a report message (generated by Message Queuing) is sent to a report queue each time the message passes through a Message Queuing routing server. The report queue is specified by the source Queue Manager. Report queues are not limited to report messages generated by Message Queuing; your application-generated messages can also be sent to report queues.

Using tracing involves setting up Active Directory and specifying a report queue for the Message Queuing enterprise. The administrator configures these settings.

The following code example gets and sets the value of a message's UseTracing property.

// Set the message's UseTracing property to true.
orderMessage.UseTracing = true;

// Display the new 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
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft