.NET Framework Class Library  

MessageEnumerator.MoveNext Method ()

Advances the enumerator to the next message in the queue, if one is currently available.

[Visual Basic]
Overloads Public Overridable Function MoveNext() As Boolean Implements _
   IEnumerator.MoveNext
[C#]
public virtual bool MoveNext();
[C++]
public: virtual bool MoveNext();
[JScript]
public function MoveNext() : Boolean;

Return Value

true if the enumerator was succesfully advanced to the next message; false if the enumerator has reached the end of the queue.

Implements

IEnumerator.MoveNext

Exceptions

Exception Type Condition
MessageQueueException An exception specific to Message Queuing was thrown.

Remarks

This overload returns immediately if there is no message in the queue. There is another overload that waits a specified TimeSpan for a message to arrive.

If a message is not currently available because the queue is empty or because you have moved beyond the last element in the collection, MoveNext returns false to the calling method.

Upon creation, an enumerator is conceptually positioned before the first message of the queue, and the first call to MoveNext brings the first message of the queue into view.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

.NET Framework Security: 

See Also

MessageEnumerator Class | MessageEnumerator Members | System.Messaging Namespace | MessageEnumerator.MoveNext Overload List | Current | Reset | Message