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

Przechowywanie MessageEnumerator komunikatów zawartych w kolejce.

Uwagi

GetMessageEnumerator2 Tworzy dynamiczną listę wszystkich komunikatów w kolejce. Komunikat w bieżącej pozycji modułu wyliczającego można usunąć z kolejki, wywołując RemoveCurrent dla tej MessageEnumerator zwracanej GetMessageEnumerator2 wartości.

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 umieszczonego poza bieżącą pozycją kursora, ale nie komunikat o wyższym priorytcie wstawiony przed tym położeniem. Można jednak zresetować wyliczenie, przenosząc kursor z powrotem na początek listy, wywołując Reset polecenie MessageEnumerator.

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

Jeśli chcesz utworzyć statyczną migawkę komunikatów w kolejce, a nie dynamiczne połączenie z nimi, wywołaj metodę GetAllMessages. Ta metoda zwraca tablicę Message obiektów, które reprezentują komunikaty w czasie wywoływanej metody.

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

Tryb grupy roboczej Available
Komputer lokalny Yes
Nazwa komputera lokalnego i bezpośredniego formatu Yes
Komputer zdalny Yes
Nazwa komputera zdalnego i bezpośredniego formatu Yes

Dotyczy

Zobacz też