MessageQueue.GetMessageEnumerator2 Método

public:
 System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();

public System.Messaging.MessageEnumerator GetMessageEnumerator2();

member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumerator

Public Function GetMessageEnumerator2 () As MessageEnumerator

Devoluções

A MessageEnumerator conter as mensagens contidas na fila.

Observações

GetMessageEnumerator2 cria uma lista dinâmica de todas as mensagens numa fila. Pode remover da fila a mensagem na posição atual do enumerador chamando RemoveCurrent o MessageEnumerator que GetMessageEnumerator2 retorna.

Como o cursor está associado à lista dinâmica de mensagens na fila, a enumeração reflete qualquer modificação que faça às mensagens na fila, se a mensagem estiver para além da posição atual do cursor. Por exemplo, o enumerador pode aceder automaticamente a uma mensagem de menor prioridade colocada para além da posição atual do cursor, mas não a uma mensagem de prioridade superior inserida antes dessa posição. No entanto, pode reiniciar a enumeração, movendo assim o cursor de volta para o início da lista, chamando Reset o MessageEnumerator.

A ordem das mensagens na enumeração reflete a sua ordem na fila, pelo que as mensagens de prioridade superior aparecerão antes das de prioridade inferior.

Se quiser um snapshot estático das mensagens na fila em vez de uma ligação dinâmica a elas, chame GetAllMessages. Este método devolve um array de Message objetos, que representam as mensagens no momento em que o método foi chamado.

A tabela seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.

Ver também

• GetAllMessages()
• GetMessageQueueEnumerator()