Receive(TimeSpan,MessageQueueTransaction) Method

Receives the first message available in the transactional queue referenced by the MessageQueue and waits until either a message is available in the queue, or the time-out expires.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Overloads Function Receive( _
   ByVal timeout As TimeSpan, _
   ByVal transaction As MessageQueueTransaction _
) As Message

'Usage
 
Dim instance As MessageQueue
Dim timeout As TimeSpan
Dim transaction As MessageQueueTransaction
Dim value As Message
 
value = instance.Receive(timeout, transaction)

public Message Receive( 
   TimeSpan timeout,
   MessageQueueTransaction transaction
)

public:
Message^ Receive( 
   TimeSpan timeout,
   MessageQueueTransaction^ transaction
)

Parameters

timeout: A System.TimeSpan that indicates the time to wait until a new message is available for inspection.
transaction: The MessageQueueTransaction object.

Return Value

A Message that references the first message available in the queue.

Exceptions

Exception	Description
System.ArgumentException	The value specified for the timeout parameter is not valid, possibly timeout is less than System.TimeSpan.Zero or greater than InfiniteTimeout.
MessageQueueException	A message did not arrive in the queue before the time-out expired.-or- The queue is non-transactional.-or- An error occurred when accessing a Message Queuing method.

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

MessageQueue Class
MessageQueue Members
Overload List