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.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft