MessageQueue.GetMessageEnumerator2 Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria um objeto enumerador para todas as mensagens na fila.
public:
System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();public System.Messaging.MessageEnumerator GetMessageEnumerator2 ();member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumeratorPublic Function GetMessageEnumerator2 () As MessageEnumeratorRetornos
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.
| Modo de grupo de trabalho | Disponível |
|---|---|
| Computador local | Yes |
| Nome do computador local e do formato direto | Yes |
| Computador remoto | Yes |
| Computador remoto e nome de formato direto | Yes |
