DefaultPropertiesToSend.TimeToReachQueue DefaultPropertiesToSend.TimeToReachQueue DefaultPropertiesToSend.TimeToReachQueue DefaultPropertiesToSend.TimeToReachQueue Property

Definition

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

public:
 property TimeSpan TimeToReachQueue { TimeSpan get(); void set(TimeSpan value); };
[System.ComponentModel.TypeConverter(typeof(System.Messaging.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToReachQueue")]
[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
public TimeSpan TimeToReachQueue { get; set; }
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.

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