MessageEnumerator.MoveNext Метод

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Перемещает перечислитель на следующее сообщение в очереди.

Перегрузки

MoveNext()	Перемещает перечислитель на следующее сообщение в очереди, если таковое в данный момент имеется.
MoveNext(TimeSpan)	Перемещает перечислитель на следующее сообщение в очереди. Если перечислитель установлен в конец очереди, метод MoveNext() ожидает до тех пор, пока не появится сообщение или же не истечет заданный тайм-аут.

MoveNext()

Перемещает перечислитель на следующее сообщение в очереди, если таковое в данный момент имеется.

public:
 virtual bool MoveNext();

public bool MoveNext ();

abstract member MoveNext : unit -> bool
override this.MoveNext : unit -> bool

Public Function MoveNext () As Boolean

Возвращаемое значение

Boolean

Значение true, если перечислитель был успешно перемещен на следующее сообщение; значение false, если перечислитель достиг конца очереди.

Реализации

MoveNext()

Исключения

MessageQueueException

Возникло исключение, характерное для Message Queuing.

Комментарии

Эта перегрузка возвращается немедленно, если в очереди нет сообщения. Существует еще одна перегрузка, которая ожидает указанного TimeSpan сообщения.

Если сообщение в настоящее время недоступно из-за того, что очередь пуста или вы переместились за пределы последнего элемента в коллекции, MoveNext возвращается false к вызывающей методу.

После создания перечислитель концептуально позиционируется перед первым сообщением очереди, а первый вызов приводит к MoveNext просмотру первого сообщения очереди.

См. также раздел

• Current
• Reset()
• Message

MoveNext(TimeSpan)

Перемещает перечислитель на следующее сообщение в очереди. Если перечислитель установлен в конец очереди, метод MoveNext() ожидает до тех пор, пока не появится сообщение или же не истечет заданный тайм-аут.

public:
 bool MoveNext(TimeSpan timeout);

public bool MoveNext (TimeSpan timeout);

member this.MoveNext : TimeSpan -> bool

Public Function MoveNext (timeout As TimeSpan) As Boolean

Параметры

timeout

TimeSpan

Время TimeSpan на ожидание сообщения в случае, когда перечислитель устанавливается в конец очереди.

Возвращаемое значение

Boolean

Значение true, если перечислитель успешно переместился на следующее сообщение; значение false, если перечислитель достиг конца очереди, и не появилось новое сообщение в течение времени, заданного параметром timeout.

Исключения

ArgumentException

Для параметра timeout задано недопустимое значение. Возможно, это отрицательное число.

MessageQueueException

Возникло исключение, характерное для Message Queuing.

-или-

Истекло время тайм-аута.

Комментарии

Эта перегрузка ожидает, если в очереди нет сообщения или курсор достиг конца очереди. Если сообщение в настоящее время недоступно, так как очередь пуста или вы переместились за пределы последнего элемента в коллекции, MoveNext ожидает указанное время ожидания.

Если курсор уже находится в конце очереди, возвращается true только в том случае, MoveNext если новое сообщение поступает в течение указанного интервала времени, имеет более низкий приоритет, чем все сообщения, находящиеся в настоящее время в очереди, и помещается в конец очереди. Перегрузка без параметра возвращается немедленно, если в очереди нет дополнительных сообщений.

При создании перечислитель концептуально позиционируется перед первым сообщением перечисления, а при первом вызове MoveNext метода выводится первое сообщение перечисления.

См. также раздел

• Current
• Reset()
• Message