DefaultPropertiesToSend.TimeToReachQueue Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.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, setPublic Property TimeToReachQueue As TimeSpanProperty 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.
