MessageEnumerator.MoveNext Método

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Avança o enumerador para a próxima mensagem na fila.

Sobrecargas

MoveNext()	Avança o enumerador para a próxima mensagem na fila, se houver um disponível no momento.
MoveNext(TimeSpan)	Avança o enumerador para a próxima mensagem na fila. Se o enumerador estiver posicionado no final da fila, o MoveNext() aguardará até uma mensagem estar disponível ou o tempo limite determinado ser atingido.

MoveNext()

Avança o enumerador para a próxima mensagem na fila, se houver um disponível no momento.

public:
 virtual bool MoveNext();

public bool MoveNext ();

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

Public Function MoveNext () As Boolean

Retornos

Boolean

true se o enumerador tiver avançado para a próxima mensagem com sucesso; false se o enumerador tiver atingido o final da fila.

Implementações

MoveNext()

Exceções

MessageQueueException

Foi gerada uma exceção específica de Enfileiramento de Mensagens.

Comentários

Essa sobrecarga retornará imediatamente se não houver nenhuma mensagem na fila. Há outra sobrecarga que aguarda a chegada de uma mensagem especificada TimeSpan .

Se uma mensagem não estiver disponível no momento porque a fila está vazia ou porque você foi além do último elemento na coleção, MoveNext retorna false ao método de chamada.

Após a criação, um enumerador é posicionado conceitualmente antes da primeira mensagem da fila e a primeira chamada para MoveNext coloca a primeira mensagem da fila em exibição.

Confira também

• Current
• Reset()
• Message

MoveNext(TimeSpan)

Avança o enumerador para a próxima mensagem na fila. Se o enumerador estiver posicionado no final da fila, o MoveNext() aguardará até uma mensagem estar disponível ou o tempo limite determinado ser atingido.

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

O TimeSpan a esperar uma mensagem ficar disponível se o enumerador estiver posicionado no final da fila.

Retornos

Boolean

true se o enumerador tiver avançado com êxito para a próxima mensagem; false se o enumerador tiver atingido o fim da fila e uma mensagem não ficar disponível dentro do tempo especificado pelo timeout parâmetro.

Exceções

ArgumentException

O valor especificado para o parâmetro de tempo limite é inválido. Pode representar um número negativo.

MessageQueueException

Foi gerada uma exceção específica de Enfileiramento de Mensagens.

- ou -

O tempo limite expirou.

Comentários

Essa sobrecarga aguarda se não há nenhuma mensagem na fila ou se o cursor atingiu o fim da fila. Se uma mensagem não estiver disponível no momento porque a fila está vazia ou porque você foi além do último elemento na coleção, MoveNext aguardará o tempo limite especificado.

Se o cursor já estiver no final da fila, MoveNext retornará true somente se a nova mensagem chegar dentro do intervalo de tempo especificado, tiver prioridade menor do que todas as mensagens atualmente na fila e for colocada no final da fila. Uma sobrecarga sem parâmetro retornará imediatamente se nenhuma outra mensagem estiver na fila.

Após a criação, um enumerador é posicionado conceitualmente antes da primeira mensagem da enumeração e a primeira chamada para MoveNext coloca a primeira mensagem da enumeração em exibição.

Confira também

• Current
• Reset()
• Message