MessageQueue.GetAllMessages Metoda

Definicja

Przestrzeń nazw:

System.Messaging

Zestaw:

System.Messaging.dll

Zwraca wszystkie komunikaty, które znajdują się w kolejce.

public:
 cli::array <System::Messaging::Message ^> ^ GetAllMessages();

public System.Messaging.Message[] GetAllMessages ();

member this.GetAllMessages : unit -> System.Messaging.Message[]

Public Function GetAllMessages () As Message()

Zwraca

Message[]

Tablica typu Message reprezentująca wszystkie komunikaty w kolejce w tej samej kolejności co w kolejce kolejki komunikatów.

Wyjątki

MessageQueueException

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

Przykłady

W poniższym przykładzie kodu pokazano użycie metody GetAllMessages.

// Connect to a queue on the local computer.
MessageQueue^ queue = gcnew MessageQueue(".\\exampleQueue");

// Populate an array with copies of all the messages in the queue.
array<Message^>^ msgs = queue->GetAllMessages();

// Loop through the messages.
for each(Message^ msg in msgs)
{
    // Display the label of each message.
    Console::WriteLine(msg->Label);
}

queue->Close();

// Connect to a queue on the local computer.
MessageQueue queue = new MessageQueue(".\\exampleQueue");

// Populate an array with copies of all the messages in the queue.
Message[] msgs = queue.GetAllMessages();

// Loop through the messages.
foreach(Message msg in msgs)
{
    // Display the label of each message.
    Console.WriteLine(msg.Label);
}

Uwagi

GetAllMessages Zwraca statyczną migawkę komunikatów w kolejce, a nie dynamiczne linki do tych komunikatów. W związku z tym nie można użyć tablicy do modyfikowania komunikatów w kolejce. Jeśli chcesz w czasie rzeczywistym, dynamiczna interakcja z kolejką (na przykład możliwość usuwania komunikatów), wywołaj GetMessageEnumerator2 metodę , która zwraca dynamiczną listę komunikatów w kolejce.

Ponieważ GetAllMessages zwraca kopię komunikatów w kolejce w momencie wywołania metody , tablica nie odzwierciedla nowych komunikatów przybywających do kolejki lub komunikatów, które są usuwane z kolejki.

GetAllMessages pobiera tylko te właściwości, które nie są filtrowane przez MessageReadPropertyFilter właściwość .

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
Nazwa komputera lokalnego i bezpośredniego formatu	Tak
Komputer zdalny	Nie
Nazwa komputera zdalnego i bezpośredniego formatu	Tak

Zobacz też

• Message
• GetMessageEnumerator2()