MessagePropertyFilter.DestinationQueue Property

Definition

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

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

Property Value

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

Attributes

Examples

The following code example demonstrates the use of the DestinationQueue property.

// Set the queue's MessageReadPropertyFilter property to enable the
// message's DestinationQueue property.
queue.MessageReadPropertyFilter.DestinationQueue = 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 DestinationQueue.QueueName
// property.
Console.WriteLine("Message.DestinationQueue.QueueName: {0}",
    orderMessage.DestinationQueue.QueueName);

Remarks

The DestinationQueue property of the Message class identifies the original destination queue of the message. It is typically used to determine the original destination of a message that is in a journal or dead-letter queue. It can also be used when sending a response message back to a response queue.

Applies to

Product Versions
.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