Udostępnij za pośrednictwem


MessageQueue.GetMessageEnumerator2 Metoda

Definicja

Tworzy obiekt modułu wyliczającego dla wszystkich komunikatów w kolejce.

public:
 System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();
public System.Messaging.MessageEnumerator GetMessageEnumerator2 ();
member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumerator
Public Function GetMessageEnumerator2 () As MessageEnumerator

Zwraca

Przechowujące MessageEnumerator komunikaty zawarte w kolejce.

Uwagi

GetMessageEnumerator2 Tworzy dynamiczną listę wszystkich komunikatów w kolejce. Komunikat można usunąć z kolejki w bieżącej pozycji modułu wyliczającego, wywołując RemoveCurrent polecenie zwracania MessageEnumeratorGetMessageEnumerator2 .

Ponieważ kursor jest skojarzony z dynamiczną listą komunikatów w kolejce, wyliczenie odzwierciedla wszelkie modyfikacje wprowadzone w komunikatach w kolejce, jeśli komunikat znajduje się poza bieżącym położeniem kursora. Na przykład moduł wyliczający może automatycznie uzyskać dostęp do komunikatu o niższym priorytcie umieszczonym poza bieżącą pozycją kursora, ale nie komunikatem o wyższym priorytetzie wstawionym przed tym położeniem. Można jednak zresetować wyliczenie, przenosząc kursor z powrotem na początek listy, wywołując polecenie ResetMessageEnumerator.

Kolejność komunikatów w wyliczenie odzwierciedla ich kolejność w kolejce, więc komunikaty o wyższym priorytetu będą wyświetlane przed niższym priorytetem.

Jeśli chcesz, aby statyczna migawka komunikatów w kolejce, a nie połączenie dynamiczne z nimi, wywołaj metodę GetAllMessages. Ta metoda zwraca tablicę Message obiektów, które reprezentują komunikaty w momencie wywołania metody.

W poniższej tabeli przedstawiono, czy ta metoda jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej Dostępne
Komputer lokalny Tak
Komputer lokalny i nazwa formatu bezpośredniego Tak
Komputer zdalny Tak
Nazwa komputera zdalnego i formatu bezpośredniego Tak

Dotyczy

Zobacz też