MessageEnumerator.MoveNext Método

  • Referencia

Definición

Espacio de nombres:
System.Messaging
Ensamblado:
System.Messaging.dll

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 -> bool
Public Function MoveNext () As Boolean

Devoluciones

Boolean

true si el enumerador avanzó correctamente al siguiente mensaje; false si el enumerador alcanzó el final de la cola.

Implementaciones

MoveNext()

Excepciones

MessageQueueException

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 -> bool
Public Function MoveNext (timeout As TimeSpan) As Boolean

Pará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

Boolean

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

ArgumentException

El valor especificado para el parámetro de tiempo de espera no es válido. Podría representar un número negativo.

MessageQueueException

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.

Consulte también

Se aplica a