DefaultPropertiesToSend.TimeToReachQueue Property

public:
 property TimeSpan TimeToReachQueue { TimeSpan get(); void set(TimeSpan value); };

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

[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToReachQueue")>]
member this.TimeToReachQueue : TimeSpan with get, set

Public Property TimeToReachQueue As TimeSpan

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

TypeConverterAttribute MessagingDescriptionAttribute

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

See also

• TimeToBeReceived
• InfiniteTimeout
• TimeToReachQueue