MessagePropertyFilter.UseTracing 属性
定义
获取或设置一个值,该值指示接收或查看消息时是否检索 UseTracing 属性信息。Gets or sets a value that indicates whether to retrieve UseTracing property information when receiving or peeking a message.
public:
property bool UseTracing { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MsgUseTracing")]
public bool UseTracing { get; set; }
[<System.Messaging.MessagingDescription("MsgUseTracing")>]
member this.UseTracing : bool with get, set
Public Property UseTracing As Boolean
属性值
如果接收 UseTracing 信息,则为 true;否则为 false。true to receive UseTracing information; otherwise, false. 默认值为 false。The default is false.
- 属性
示例
下面的代码示例演示属性的用法 UseTracing 。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);
// 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);
注解
UseTracing类的属性 Message 指定是否跟踪消息在到达其目标队列时的路由。The UseTracing property of the Message class specifies whether to track the route of a message as it moves toward its destination queue. 如果为 true ,则每次原始消息通过消息队列路由服务器时,都会向系统报告队列发送消息队列生成的报告消息。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.
使用跟踪涉及到设置 Active Directory 和为消息队列企业指定报表队列。Using tracing involves setting up Active Directory and specifying a report queue for the Message Queuing enterprise. 这些设置由管理员配置。These settings are configured by the administrator.