MessageQueue.GetMessageEnumerator 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.
Attenzione
This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.
Crea un oggetto enumeratore per tutti i messaggi nella coda. GetMessageEnumerator() è obsoleto. In alternativa, è necessario usare GetMessageEnumerator2().
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 MessageEnumeratorValori restituiti
Oggetto MessageEnumerator contenente i messaggi contenuti nella coda.
- Attributi
Commenti
GetMessageEnumerator 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 GetMessageEnumerator .
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à inferiore.
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 del metodo.
Nella tabella seguente viene illustrato se questo metodo è disponibile in varie modalità gruppo di lavoro.
| Modalità gruppo di lavoro | Disponibile |
|---|---|
| Computer locale | Yes |
| Computer locale e nome del formato diretto | Yes |
| Computer remoto | Yes |
| Computer remoto e nome del formato diretto | Yes |