MessageQueue.GetMessageEnumerator 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.
Achtung
This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.
Erstellt ein Enumerationsobjekt für alle Nachrichten in der Warteschlange. GetMessageEnumerator() ist veraltet. GetMessageEnumerator2() sollte stattdessen verwendet werden.
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 MessageEnumeratorGibt zurück
Die MessageEnumerator in der Warteschlange enthaltenen Nachrichten.
- Attribute
Hinweise
GetMessageEnumerator 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 aufrufenGetMessageEnumerator.
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 |
