MessageQueue.GetMessageEnumerator 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.
Atenção
This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.
Cria um objeto enumerador para todas as mensagens na fila. GetMessageEnumerator() está obsoleto. GetMessageEnumerator2() em vez disso, deve ser utilizado.
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.MessageEnumeratorPublic Function GetMessageEnumerator () As MessageEnumeratorDevoluções
A MessageEnumerator conter as mensagens contidas na fila.
- Atributos
Observações
GetMessageEnumerator 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 GetMessageEnumerator 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.
| Modo de grupo de trabalho | Available |
|---|---|
| Computador local | Yes |
| Computador local e nome do formato direto | Yes |
| Computador remoto | Yes |
| Computador remoto e nome do formato direto | Yes |