Condividi tramite


MessageQueue.GetMessageEnumerator2 Metodo

Definizione

Crea un oggetto enumeratore per tutti i messaggi contenuti nella coda.

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.

Commenti

GetMessageEnumerator2 crea un elenco dinamico di tutti i messaggi in una coda. È possibile rimuovere dalla coda il messaggio nella posizione corrente dell'enumeratore chiamando RemoveCurrent per l'oggetto MessageEnumerator restituito GetMessageEnumerator2 .

Poiché il cursore è associato all'elenco dinamico di messaggi nella coda, l'enumerazione riflette tutte le modifiche apportate ai messaggi nella coda, se il messaggio supera la posizione corrente del cursore. Ad esempio, l'enumeratore può accedere automaticamente a un messaggio con priorità inferiore posizionato oltre la posizione corrente del cursore, ma non a un messaggio con priorità più alta inserito prima di tale posizione. Tuttavia, è possibile reimpostare l'enumerazione, spostando il cursore all'inizio dell'elenco, chiamando Reset per .MessageEnumerator

L'ordine dei messaggi nell'enumerazione riflette l'ordine nella coda, quindi i messaggi con priorità più alta verranno visualizzati prima di quelli con priorità più bassa.

Se si vuole uno snapshot statico dei messaggi nella coda anziché una connessione dinamica, chiamare GetAllMessages. Questo metodo restituisce una matrice di Message oggetti che rappresentano i messaggi al momento della chiamata al metodo .

Nella tabella seguente viene illustrato se questo metodo è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro Disponibile
Computer locale
Computer locale e nome del formato diretto
Computer remoto
Nome del formato diretto e del computer remoto

Si applica a

Vedi anche