Edit

Share via


DefaultPropertiesToSend.TimeToReachQueue Property

Definition

Gets or sets the time limit for the message to reach the queue.

[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToReachQueue")]
public TimeSpan TimeToReachQueue { get; set; }

Property Value

The time limit in seconds for a message to reach the destination queue, from the time the message is sent. The default is InfiniteTimeout.

Attributes

Remarks

If the TimeToReachQueue interval expires before the message reaches its destination, the Message Queuing application discards the message. The message is either sent to the dead-letter queue, if the message's UseDeadLetterQueue property is set to true, or ignored, if UseDeadLetterQueue is false. If TimeToReachQueue is greater than TimeToBeReceived, TimeToBeReceived takes precedence.

The message's AcknowledgeType property can be set to request that Message Queuing send a negative acknowledgment message back to the sending application if the message does not arrive before the timer expires.

If TimeToReachQueue is 0 seconds, Message Queuing tries once to send the message to its destination if the queue is waiting for the message. If the queue is local, the message always reaches the queue.

When several messages are sent in a transaction, Message Queuing uses the value of the first message's TimeToReachQueue property.

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