MessageQueue.GetMessageEnumerator Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Uwaga
This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.
Tworzy obiekt modułu wyliczającego dla wszystkich komunikatów w kolejce. GetMessageEnumerator() jest przestarzałe. GetMessageEnumerator2() Należy użyć zamiast tego.
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 MessageEnumeratorZwraca
Przechowywanie MessageEnumerator komunikatów zawartych w kolejce.
- Atrybuty
Uwagi
GetMessageEnumerator 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 GetMessageEnumerator 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 |
