MessageQueue.GetMessageEnumerator Método

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

public System.Messaging.MessageEnumerator GetMessageEnumerator();

[System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")]
public System.Messaging.MessageEnumerator GetMessageEnumerator();

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

[<System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")>]
member this.GetMessageEnumerator : unit -> System.Messaging.MessageEnumerator

Public Function GetMessageEnumerator () As MessageEnumerator

Retornos

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

Atributos

ObsoleteAttribute

Comentários

GetMessageEnumerator 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 GetMessageEnumerator 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()
• GetMessageEnumerator2()
• GetMessageQueueEnumerator()