Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

QueueDescription::ForwardTo Property

Gets or sets the path to the recipient to which the message is forwarded.

Namespace:  Microsoft.ServiceBus.Messaging
Assembly:  Microsoft.ServiceBus (in Microsoft.ServiceBus.dll)

property String^ ForwardTo {
	String^ get ();
	void set (String^ value);

Property Value

Type: System::String
The path to the recipient to which the message is forwarded.

ForwardTo enables you to chain messaging entities and create topologies. The recipient can be a queue or topic. After you set this property on a queue, messages cannot be directly received from that queue.

Service Bus supports automatic message forwarding from a partitioned queue (source) into a partitioned queue or topic (destination) by setting the ForwardTo property on the source queue. If the message contains a partition key (SessionId, PartitionKey, or MessageId if the RequiresDuplicateDetection property is set to true), the key is used for the source queue as well as for the destination entity. If you use a transaction to send messages to the source queue the message must have the SessionId or PartitionKey properties set. If a single transaction is used to send multiple messages to the source queue, all messages must use the same partition key.

Note that if the destination entity has many messages accumulated and exceeds the quota, or the destination entity is disabled, the source entity adds the messages to its dead-letter queue until there is space in the destination (or the entity is re-enabled). Those messages will continue to live in the dead-letter queue, so you must explicitly receive and process them from the dead-letter queue.

For more information, see Chaining Service Bus entities with Auto-forwarding.

Community Additions

© 2015 Microsoft