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 Meldungen 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
Ein MessageEnumerator mit den in der Warteschlange enthaltenen Meldungen.
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 für den aufrufenRemoveCurrent, GetMessageEnumerator2 der MessageEnumerator zurückgibt.
Da der Cursor der dynamischen Liste von Nachrichten in der Warteschlange zugeordnet ist, spiegelt die Enumeration alle Änderungen wider, die Sie an den Nachrichten in der Warteschlange vornehmen, wenn die Nachricht die aktuelle Cursorposition überschreitet. Beispielsweise kann der Enumerator automatisch auf eine Nachricht mit niedrigerer Priorität zugreifen, die außerhalb der aktuellen Position des Cursors platziert wird, aber nicht auf eine Nachricht mit höherer Priorität, die vor dieser Position eingefügt wird. Sie können die Enumeration jedoch zurücksetzen und dadurch den Cursor zurück an den Anfang der Liste verschieben, indem Sie für MessageEnumeratoraufrufenReset.
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 anstelle einer dynamischen Verbindung mit ihnen wünschen, rufen Sie GetAllMessagesauf. Diese Methode gibt ein Array von Message -Objekten zurück, die die Nachrichten zum Zeitpunkt des Aufrufs der Methode darstellen.
Die folgende Tabelle zeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.
| Arbeitsgruppenmodus | Verfügbar |
|---|---|
| Lokalem Computer | Ja |
| Name des lokalen Computers und direktes Format | Ja |
| Remotecomputer | Ja |
| Name des Remotecomputers und des direkten Formats | Ja |
