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

Definizione

Crea un oggetto enumeratore per tutti i messaggi contenuti nella coda.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

Restituisce

MessageEnumerator contenente i messaggi presenti nella coda.The MessageEnumerator holding the messages that are contained in the queue.

Commenti

GetMessageEnumerator2Crea un elenco dinamico di tutti i messaggi in una coda.GetMessageEnumerator2 creates a dynamic list of all the messages in a queue. È possibile rimuovere dalla coda il messaggio in corrispondenza della posizione corrente dell'enumeratore chiamando RemoveCurrent per l' MessageEnumerator oggetto GetMessageEnumerator2 che restituisce.You can remove from the queue the message at the enumerator's current position by calling RemoveCurrent for the MessageEnumerator that GetMessageEnumerator2 returns.

Poiché il cursore è associato all'elenco dinamico dei messaggi nella coda, l'enumerazione riflette tutte le modifiche apportate ai messaggi nella coda, se il messaggio supera la posizione corrente del cursore.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. Ad esempio, l'enumeratore può accedere automaticamente a un messaggio di priorità inferiore posizionato oltre la posizione corrente del cursore, ma non a un messaggio con priorità più alta inserito prima di tale posizione.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. Tuttavia, è possibile reimpostare l'enumerazione, spostando di nuovo il cursore all'inizio dell'elenco, chiamando Reset MessageEnumeratorper.However, you can reset the enumeration, thereby moving the cursor back to the beginning of the list, by calling Reset for the MessageEnumerator.

L'ordine dei messaggi nell'enumerazione riflette il relativo ordine nella coda, quindi i messaggi con priorità più elevata verranno visualizzati prima di quelli con priorità più bassa.The order of the messages in the enumeration reflects their order in the queue, so higher-priority messages will appear before lower-priority ones.

Se si vuole uno snapshot statico dei messaggi nella coda anziché una connessione dinamica, chiamare GetAllMessages.If you want a static snapshot of the messages in the queue rather than a dynamic connection to them, call GetAllMessages. Questo metodo restituisce una matrice di Message oggetti che rappresentano i messaggi nel momento in cui è stato chiamato il metodo.This method returns an array of Message objects, which represent the messages at the time the method was called.

Nella tabella seguente viene indicato se questo metodo è disponibile in diverse modalità del gruppo di lavoro.The following table shows whether this method is available in various Workgroup modes.

Modalità gruppo di lavoroWorkgroup mode DisponibileAvailable
Computer localeLocal computer Yes
Nome del computer locale e del formato direttoLocal computer and direct format name Yes
Computer remotoRemote computer Yes
Nome del computer remoto e del formato direttoRemote computer and direct format name Yes

Si applica a

Vedi anche