MessageQueue.GetMessageEnumerator2 Methode

Definition

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.MessageEnumerator
Public Function GetMessageEnumerator2 () As MessageEnumerator

Gibt 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

Gilt für:

Weitere Informationen