MessageQueue.GetMessageEnumerator2 Método

  • Referência

Definição

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

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.MessageEnumerator
Public Function GetMessageEnumerator2 () As MessageEnumerator

Retornos

MessageEnumerator

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

Aplica-se a

Confira também