MessageQueue.GetMessageEnumerator2 MessageQueue.GetMessageEnumerator2 MessageQueue.GetMessageEnumerator2 MessageQueue.GetMessageEnumerator2 Method

Definición

Crea un objeto enumerador para todos los mensajes de la cola.Creates an enumerator object for all the messages in the queue.

public:
 System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();
public System.Messaging.MessageEnumerator GetMessageEnumerator2 ();
member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumerator
Public Function GetMessageEnumerator2 () As MessageEnumerator

Devoluciones

MessageEnumerator que contiene los mensajes de la cola.The MessageEnumerator holding the messages that are contained in the queue.

Comentarios

GetMessageEnumerator2 crea una lista dinámica de todos los mensajes de una cola.GetMessageEnumerator2 creates a dynamic list of all the messages in a queue. Puede quitar de la cola el mensaje en la posición actual del enumerador mediante una llamada a RemoveCurrent para el MessageEnumerator que GetMessageEnumerator2 devuelve.You can remove from the queue the message at the enumerator's current position by calling RemoveCurrent for the MessageEnumerator that GetMessageEnumerator2 returns.

Dado que el cursor está asociado a la lista dinámica de mensajes en la cola, la enumeración refleja cualquier modificación realizada en los mensajes de la cola, si el mensaje está más allá de la posición actual del cursor.Because the cursor is associated with the dynamic list of messages in the queue, the enumeration reflects any modification you make to the messages in the queue, if the message is beyond the current cursor position. Por ejemplo, el enumerador puede tener acceso automáticamente a un mensaje de menor prioridad situado más allá de la posición del cursor actual, pero no un mensaje de prioridad más alta insertado antes de esa posición.For example, the enumerator can automatically access a lower-priority message placed beyond the cursor's current position, but not a higher-priority message inserted before that position. Sin embargo, puede restablecer la enumeración, con lo que desplaza el cursor al principio de la lista, mediante una llamada a Reset para el MessageEnumerator.However, you can reset the enumeration, thereby moving the cursor back to the beginning of the list, by calling Reset for the MessageEnumerator.

El orden de los mensajes en la enumeración refleja su orden en la cola, por lo que aparecerán mensajes de prioridad más alta antes que las de prioridad inferior.The order of the messages in the enumeration reflects their order in the queue, so higher-priority messages will appear before lower-priority ones.

Si desea una instantánea estática de los mensajes en la cola en lugar de una conexión dinámica con ellos, llame a GetAllMessages.If you want a static snapshot of the messages in the queue rather than a dynamic connection to them, call GetAllMessages. Este método devuelve una matriz de Message objetos que representan los mensajes en el momento en que se llamó al método.This method returns an array of Message objects, which represent the messages at the time the method was called.

En la tabla siguiente se muestra si este método está disponible en los distintos modos de grupo de trabajo.The following table shows whether this method is available in various Workgroup modes.

Modo de grupo de trabajoWorkgroup mode DisponibleAvailable
Equipo localLocal computer Yes
Equipo local y el nombre de formato directoLocal computer and direct format name Yes
Equipo remotoRemote computer Yes
Equipo remoto y el nombre de formato directoRemote computer and direct format name Yes

Se aplica a

Consulte también: