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
| Nome | Description |
|---|---|
| MoveNext() |
Avança o enumerador para a próxima mensagem na fila, se um estiver 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, MoveNext() aguardará até que uma mensagem esteja disponível ou o tempo limite especificado expire. |
MoveNext()
Avança o enumerador para a próxima mensagem na fila, se um estiver 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 foi avançado com êxito para a próxima mensagem; false se o enumerador tiver atingido o final da fila.
Implementações
Exceções
Uma exceção específica ao Enfileiramento de Mensagens foi gerada.
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ê se moveu além do último elemento da 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 colocar 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, MoveNext() aguardará até que uma mensagem esteja disponível ou o tempo limite especificado expire.
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
A TimeSpan espera para que uma mensagem esteja disponível se o enumerador estiver posicionado no final da fila.
Retornos
true se o enumerador avançou com êxito para a próxima mensagem; false se o enumerador tiver atingido o final 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.
Uma exceção específica ao Enfileiramento de Mensagens foi gerada.
-ou-
O tempo limite expirou.
Comentários
Essa sobrecarga aguarda se não há nenhuma mensagem na fila ou se o cursor atingiu o final da fila. Se uma mensagem não estiver disponível no momento porque a fila está vazia ou porque você se moveu além do último elemento da coleção, MoveNext aguardará o tempo limite especificado.
Se o cursor já estiver no final da fila, MoveNext retornará somente true 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 exibir a primeira mensagem da enumeração.