MessageQueue.GetMessageEnumerator2 Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.MessageEnumeratorPublic Function GetMessageEnumerator2 () As MessageEnumeratorRestituisce
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 | Sì |
| Computer locale e nome del formato diretto | Sì |
| Computer remoto | Sì |
| Nome del formato diretto e del computer remoto | Sì |
