MessageEnumerator.MoveNext Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Desplaza el enumerador al siguiente mensaje de la cola.
Sobrecargas
| MoveNext() |
Desplaza el enumerador al siguiente mensaje de la cola si hay alguno disponible. |
| MoveNext(TimeSpan) |
Desplaza el enumerador al siguiente mensaje de la cola. Si el enumerador se coloca al final de la cola, MoveNext() espera hasta que haya un mensaje disponible o expire el tiempo de espera. |
MoveNext()
Desplaza el enumerador al siguiente mensaje de la cola si hay alguno disponible.
public:
virtual bool MoveNext();public bool MoveNext ();abstract member MoveNext : unit -> bool
override this.MoveNext : unit -> boolPublic Function MoveNext () As BooleanDevoluciones
true si el enumerador avanzó correctamente al siguiente mensaje; false si el enumerador alcanzó el final de la cola.
Implementaciones
Excepciones
Se ha producido una excepción específica para Message Queuing.
Comentarios
Esta sobrecarga devuelve inmediatamente si no hay ningún mensaje en la cola. Hay otra sobrecarga que espera a que llegue un mensaje especificado TimeSpan .
Si un mensaje no está disponible actualmente porque la cola está vacía o porque se ha movido más allá del último elemento de la colección, MoveNext vuelve false al método que realiza la llamada.
Tras la creación, un enumerador se coloca conceptualmente antes del primer mensaje de la cola y la primera llamada para MoveNext que se vea el primer mensaje de la cola.
Consulte también
Se aplica a
MoveNext(TimeSpan)
Desplaza el enumerador al siguiente mensaje de la cola. Si el enumerador se coloca al final de la cola, MoveNext() espera hasta que haya un mensaje disponible o expire el tiempo de espera.
public:
bool MoveNext(TimeSpan timeout);public bool MoveNext (TimeSpan timeout);member this.MoveNext : TimeSpan -> boolPublic Function MoveNext (timeout As TimeSpan) As BooleanParámetros
- timeout
- TimeSpan
TimeSpan que se va a esperar hasta que un mensaje se encuentre disponible si el enumerador se coloca al final de la cola.
Devoluciones
true si el enumerador avanzó satisfactoriamente hasta el siguiente mensaje; false si el enumerador llegó al final de la cola y un mensaje no pasa a estar disponible en el plazo de tiempo especificado por el parámetro timeout.
Excepciones
El valor especificado para el parámetro de tiempo de espera no es válido. Podría representar un número negativo.
Se ha producido una excepción específica para Message Queuing.
o bien
El tiempo de espera ha expirado.
Comentarios
Esta sobrecarga espera si no hay ningún mensaje en la cola o si el cursor ha llegado al final de la cola. Si un mensaje no está disponible actualmente porque la cola está vacía o porque se ha movido más allá del último elemento de la colección, MoveNext espera el tiempo de espera especificado.
Si el cursor ya está al final de la cola, MoveNext solo devuelve true si el nuevo mensaje llega dentro del intervalo de tiempo especificado, tiene menor prioridad que todos los mensajes actualmente en la cola y se colocan al final de la cola. Una sobrecarga sin parámetros devuelve inmediatamente si no hay más mensajes en la cola.
Tras la creación, un enumerador se coloca conceptualmente antes del primer mensaje de la enumeración y la primera llamada a MoveNext lleva el primer mensaje de la enumeración a la vista.
