MessageEnumerator.MoveNext Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Avança o enumerador para a próxima mensagem na fila.
Sobrecargas
| Name | Description |
|---|---|
| MoveNext() |
Avança o enumerador para a próxima mensagem na fila, se houver uma 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() espera até que uma mensagem esteja disponível ou que o tempo limite expire. |
MoveNext()
Avança o enumerador para a próxima mensagem na fila, se houver uma disponível no momento.
public:
virtual bool MoveNext();public bool MoveNext();abstract member MoveNext : unit -> bool
override this.MoveNext : unit -> boolPublic Function MoveNext () As BooleanDevoluções
true se o enumerador fosse avançado com sucesso para a mensagem seguinte; false se o enumerador tiver chegado ao fim da fila.
Implementações
Exceções
Foi lançada uma exceção específica para a Fila de Mensagens.
Observações
Esta sobrecarga regressa imediatamente se não houver mensagem na fila. Há outra sobrecarga que espera um especificado TimeSpan pela chegada de uma mensagem.
Se uma mensagem não estiver disponível no momento porque a fila está vazia ou porque ultrapassou o último elemento da coleção, MoveNext retorna false ao método de chamada.
Após a criação, um enumerador é posicionado conceptualmente antes da primeira mensagem da fila, e a primeira chamada traz MoveNext a primeira mensagem da fila à vista.
Ver 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() espera até que uma mensagem esteja disponível ou que o tempo limite 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
Depois TimeSpan , esperar que uma mensagem esteja disponível se o enumerador estiver posicionado no final da fila.
Devoluções
true se o enumerador avançar com sucesso para a mensagem seguinte; false se o enumerador tiver chegado ao 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 timeout é inválido. Pode representar um número negativo.
Foi lançada uma exceção específica para a Fila de Mensagens.
-ou-
O tempo expirou.
Observações
Esta sobrecarga espera se não houver mensagem na fila ou se o cursor tiver chegado ao fim da fila. Se uma mensagem não estiver disponível atualmente porque a fila está vazia ou porque ultrapassou o último elemento da coleção, MoveNext aguarda o tempo limite especificado.
Se o cursor já estiver no final da fila, MoveNext só retorna true se a nova mensagem chegar dentro do intervalo de tempo especificado, tiver prioridade inferior a todas as mensagens atualmente na fila e for colocada no final da fila. Uma sobrecarga sem parâmetro retorna imediatamente se não houver mais mensagens na fila.
Após a criação, um enumerador é conceptualmente posicionado antes da primeira mensagem da enumeração, e a primeira chamada para MoveNext traz a primeira mensagem da enumeração à vista.