MessageQueue.GetMessageEnumerator2 Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un objeto enumerador para todos los mensajes de la cola.
public:
System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();public System.Messaging.MessageEnumerator GetMessageEnumerator2 ();member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumeratorPublic Function GetMessageEnumerator2 () As MessageEnumeratorDevoluciones
MessageEnumerator que contiene los mensajes de la cola.
Comentarios
GetMessageEnumerator2 crea una lista dinámica de todos los mensajes de una cola. Puede quitar de la cola el mensaje en la posición actual del enumerador llamando RemoveCurrent a para el MessageEnumerator que GetMessageEnumerator2 devuelve.
Dado que el cursor está asociado a la lista dinámica de mensajes de la cola, la enumeración refleja cualquier modificación que realice en los mensajes de la cola, si el mensaje está fuera de la posición actual del cursor. Por ejemplo, el enumerador puede tener acceso automáticamente a un mensaje de prioridad inferior situado más allá de la posición actual del cursor, pero no a un mensaje de prioridad superior insertado antes de esa posición. Sin embargo, puede restablecer la enumeración, moviendo el cursor de nuevo al principio de la lista llamando Reset a para .MessageEnumerator
El orden de los mensajes de la enumeración refleja su orden en la cola, por lo que los mensajes de mayor prioridad aparecerán antes de los de prioridad inferior.
Si desea una instantánea estática de los mensajes de la cola en lugar de una conexión dinámica con ellos, llame a GetAllMessages. Este método devuelve una matriz de Message objetos, que representan los mensajes en el momento en que se llamó al método .
En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.
| Modo de grupo de trabajo | Disponible |
|---|---|
| Equipo local | Sí |
| Equipo local y nombre de formato directo | Sí |
| Equipo remoto | Sí |
| Equipo remoto y nombre de formato directo | Sí |
