TimeToReachQueue Property (Message)

Gets or sets the maximum amount of time for the message to reach the queue.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
<ReadOnlyAttribute(True)>
<DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Hidden)>
<TypeConverterAttribute("System.Messaging.Design.TimeoutConverter, System.Messaging, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>
<MessagingDescriptionAttribute("Specifies a time limit (in seconds) for the message to reach the queue. Use "Infinity" to set the maximum value.")>
Public Property TimeToReachQueue As TimeSpan

'Usage
 
Dim instance As Message
Dim value As TimeSpan
 
instance.TimeToReachQueue = value
 
value = instance.TimeToReachQueue

[ReadOnly(true)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[TypeConverter("System.Messaging.Design.TimeoutConverter, System.Messaging, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[MessagingDescription("Specifies a time limit (in seconds) for the message to reach the queue. Use "Infinity" to set the maximum value.")]
public TimeSpan TimeToReachQueue {get; set;}

[ReadOnly(true)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[TypeConverter("System.Messaging.Design.TimeoutConverter, System.Messaging, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[MessagingDescription("Specifies a time limit (in seconds) for the message to reach the queue. Use "Infinity" to set the maximum value.")]
public:
property TimeSpan TimeToReachQueue {
   TimeSpan get();
   void set (    TimeSpan value);
}

Property Value

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

Exceptions

Exception	Description
System.InvalidOperationException	The message queue is filtered to ignore the TimeToReachQueue property.
System.ArgumentException	The value specified for TimeToReachQueue is invalid. It might represent a negative number.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

Message Class
Message Members