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, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft