MessageEnumerator.MoveNext Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> boolPublic Function MoveNext () As BooleanRetornos
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
Exceções
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
Aplica-se a
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 -> boolPublic Function MoveNext (timeout As TimeSpan) As BooleanParâmetros
- timeout
- TimeSpan
O TimeSpan a esperar uma mensagem ficar disponível se o enumerador estiver posicionado no final da fila.
Retornos
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
O valor especificado para o parâmetro de tempo limite é inválido. Pode representar um número negativo.
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.
