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

O MessageEnumerator mantém as mensagens que estão 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 para o MessageEnumerator que GetMessageEnumerator2 retorna.

Como o cursor está associado à lista dinâmica de mensagens na fila, a enumeração refletirá 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 mais baixa 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 assim o cursor de volta para o início da lista, chamando Reset para o MessageEnumerator.

A ordem das mensagens na enumeração reflete sua ordem na fila, portanto, as mensagens de prioridade mais alta aparecerão antes das de prioridade mais baixa.

Se você quiser uma instantâneo estática 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.

Aplica-se a

Confira também

• GetAllMessages()
• GetMessageQueueEnumerator()