MessageEnumerator.MoveNext Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перемещает перечислитель на следующее сообщение в очереди.
Перегрузки
| MoveNext() |
Перемещает перечислитель на следующее сообщение в очереди, если таковое в данный момент имеется. |
| MoveNext(TimeSpan) |
Перемещает перечислитель на следующее сообщение в очереди. Если перечислитель установлен в конец очереди, метод MoveNext() ожидает до тех пор, пока не появится сообщение или же не истечет заданный тайм-аут. |
MoveNext()
Перемещает перечислитель на следующее сообщение в очереди, если таковое в данный момент имеется.
public:
virtual bool MoveNext();public bool MoveNext ();abstract member MoveNext : unit -> bool
override this.MoveNext : unit -> boolPublic Function MoveNext () As BooleanВозвращаемое значение
Значение true, если перечислитель был успешно перемещен на следующее сообщение; значение false, если перечислитель достиг конца очереди.
Реализации
Исключения
Возникло исключение, характерное для Message Queuing.
Комментарии
Эта перегрузка возвращается немедленно, если в очереди нет сообщения. Существует еще одна перегрузка, которая ожидает указанного TimeSpan сообщения.
Если сообщение в настоящее время недоступно из-за того, что очередь пуста или вы переместились за пределы последнего элемента в коллекции, MoveNext возвращается false к вызывающей методу.
После создания перечислитель концептуально позиционируется перед первым сообщением очереди, а первый вызов приводит к MoveNext просмотру первого сообщения очереди.
См. также раздел
Применяется к
MoveNext(TimeSpan)
Перемещает перечислитель на следующее сообщение в очереди. Если перечислитель установлен в конец очереди, метод MoveNext() ожидает до тех пор, пока не появится сообщение или же не истечет заданный тайм-аут.
public:
bool MoveNext(TimeSpan timeout);public bool MoveNext (TimeSpan timeout);member this.MoveNext : TimeSpan -> boolPublic Function MoveNext (timeout As TimeSpan) As BooleanПараметры
- timeout
- TimeSpan
Время TimeSpan на ожидание сообщения в случае, когда перечислитель устанавливается в конец очереди.
Возвращаемое значение
Значение true, если перечислитель успешно переместился на следующее сообщение; значение false, если перечислитель достиг конца очереди, и не появилось новое сообщение в течение времени, заданного параметром timeout.
Исключения
Для параметра timeout задано недопустимое значение. Возможно, это отрицательное число.
Возникло исключение, характерное для Message Queuing.
-или-
Истекло время тайм-аута.
Комментарии
Эта перегрузка ожидает, если в очереди нет сообщения или курсор достиг конца очереди. Если сообщение в настоящее время недоступно, так как очередь пуста или вы переместились за пределы последнего элемента в коллекции, MoveNext ожидает указанное время ожидания.
Если курсор уже находится в конце очереди, возвращается true только в том случае, MoveNext если новое сообщение поступает в течение указанного интервала времени, имеет более низкий приоритет, чем все сообщения, находящиеся в настоящее время в очереди, и помещается в конец очереди. Перегрузка без параметра возвращается немедленно, если в очереди нет дополнительных сообщений.
При создании перечислитель концептуально позиционируется перед первым сообщением перечисления, а при первом вызове MoveNext метода выводится первое сообщение перечисления.
