MessageQueue.GetMessageEnumerator 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í.
Precaución
This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.
Crea un objeto enumerador para todos los mensajes de la cola. GetMessageEnumerator() está en desuso. Se debe usar GetMessageEnumerator2() en su lugar.
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 MessageEnumeratorDevoluciones
que MessageEnumerator contiene los mensajes contenidos en la cola.
- Atributos
Comentarios
GetMessageEnumerator 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 GetMessageEnumerator 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á más allá de la posición actual del cursor. Por ejemplo, el enumerador puede acceder 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 mayor prioridad 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 a ellos, llame a GetAllMessages. Este método devuelve una matriz de Message objetos , que representa 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í |