MessagePropertyFilter.UseTracing Property

Definition

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

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

Property Value

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

Attributes

Examples

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);

Remarks

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.

Applies to

Toode Versioonid
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

See also