MessageQueue.GetMessageEnumerator2 Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt ein Enumerationsobjekt für alle Nachrichten in der Warteschlange.
public:
System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();public System.Messaging.MessageEnumerator GetMessageEnumerator2();member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumeratorPublic Function GetMessageEnumerator2 () As MessageEnumeratorGibt zurück
Die MessageEnumerator in der Warteschlange enthaltenen Nachrichten.
Hinweise
GetMessageEnumerator2 erstellt eine dynamische Liste aller Nachrichten in einer Warteschlange. Sie können die Nachricht an der aktuellen Position des Enumerators aus der Warteschlange entfernen, indem Sie die Zurückgegebene RemoveCurrentMessageEnumerator aufrufenGetMessageEnumerator2.
Da der Cursor der dynamischen Liste der Nachrichten in der Warteschlange zugeordnet ist, spiegelt die Enumeration alle Änderungen wider, die Sie an den Nachrichten in der Warteschlange vornehmen, wenn die Nachricht über die aktuelle Cursorposition hinausgeht. Beispielsweise kann der Enumerator automatisch auf eine Nachricht mit niedrigerer Priorität zugreifen, die über die aktuelle Position des Cursors hinaus platziert wird, aber keine Nachricht mit höherer Priorität, die vor dieser Position eingefügt wurde. Sie können die Aufzählung jedoch zurücksetzen, wodurch der Cursor wieder an den Anfang der Liste verschoben wird, indem Sie die Reset.-Funktion aufrufenMessageEnumerator.
Die Reihenfolge der Nachrichten in der Enumeration spiegelt ihre Reihenfolge in der Warteschlange wider, sodass Nachrichten mit höherer Priorität vor denen mit niedrigerer Priorität angezeigt werden.
Wenn Sie eine statische Momentaufnahme der Nachrichten in der Warteschlange statt einer dynamischen Verbindung mit ihnen wünschen, rufen Sie auf GetAllMessages. Diese Methode gibt ein Array von Message Objekten zurück, das die Nachrichten zum Zeitpunkt des Aufrufs der Methode darstellt.
In der folgenden Tabelle wird gezeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.
| Arbeitsgruppenmodus | Available |
|---|---|
| Lokaler Computer | Ja |
| Name des lokalen Computers und des direkten Formats | Ja |
| Remotecomputer | Ja |
| Name des Remotecomputers und des direkten Formats | Ja |
