Export (0) Print
Expand All

Message.DestinationQueue Property

Gets the intended destination queue for a message.

Namespace:  System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

[MessagingDescriptionAttribute("MsgDestinationQueue")]
public MessageQueue DestinationQueue { get; }

Property Value

Type: System.Messaging.MessageQueue
A MessageQueue that specifies the intended destination queue for the message.

ExceptionCondition
InvalidOperationException

The message has not been sent. This property can only be read on messages retrieved from a queue.

-or-

The message queue is filtered to ignore the DestinationQueue property.

The DestinationQueue property is most commonly used to determine the original destination of a message that arrived in a journal or dead-letter queue. Usually, you do not need to examine this property, because you typically retrieve the message from its destination queue.

The following code example displays the value of a message's DestinationQueue property.

// Display the value of the message's DestinationQueue property. 
// To view this property value, the queue's 
// MessageReadPropertyFilter.DestinationQueue property must be set to 
// true before the message is received.
Console.WriteLine("Message.DestinationQueue.QueueName: {0}",
    orderMessage.DestinationQueue.QueueName);

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft