NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Message.UseTracing

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

[Visual Basic]
Overridable Public Property UseTracing As Boolean
[C#]
public bool UseTracing {virtual get; virtual set;}
[C++]
public: __property virtual bool get_UseTracing();
public: __property virtual void set_UseTracing(bool);
[JScript]
public function get UseTracing() : Boolean;
public function set UseTracing(Boolean);

Property Value

true if each hop made by the original message generates a report to be sent to the system's report queue; otherwise, false. The default is false.

Exceptions

Exception Type Condition
InvalidOperationException The message queue is filtered not to read the UseTracing property.

Remarks

UseTracing provides access to the Trace property of the Message Queuing MSMQMessage object.

When a message is sent with tracing enabled, a report message is generated and sent to the system report queue each time the message passes through a Message Queuing routing server. Report queues are not limited to Message Queuing-generated report messages. Application-generated messages can be sent to report queues as well.

If UseTracing is true but the report queue is not defined by the Message Queuing application administrator for Queue Manager associated with the source of the message, this property is ignored.

See Also

Message Class | Message Members | System.Messaging Namespace