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

Retornos

A MessageEnumerator retenção das mensagens contidas na fila.

Comentários

GetMessageEnumerator2 cria uma lista dinâmica de todas as mensagens em uma fila. Você 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 feita nas mensagens na fila, se a mensagem estiver além da posição atual do cursor. Por exemplo, o enumerador pode acessar automaticamente uma mensagem de prioridade inferior colocada além da posição atual do cursor, mas não uma mensagem de prioridade mais alta inserida antes dessa posição. No entanto, você pode redefinir a enumeração, movendo o cursor de volta para o início da lista, chamando Reset o MessageEnumerator.

A ordem das mensagens na enumeração reflete sua ordem na fila, de modo que as mensagens de prioridade mais alta serão exibidas antes das de prioridade mais baixa.

Se você quiser um instantâneo estático das mensagens na fila em vez de uma conexão dinâmica com elas, chame GetAllMessages. Esse método retorna uma matriz de Message objetos, que representam as mensagens no momento em que o método foi chamado.

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

Confira também

• GetAllMessages()
• GetMessageQueueEnumerator()