MessageQueue.GetAllMessages Methode

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

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

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

Public Function GetAllMessages () As Message()

Retouren

Een matrix van het type Message dat alle berichten in de wachtrij vertegenwoordigt, in dezelfde volgorde als in de Message Queuing-wachtrij.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van 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);
}

Opmerkingen

GetAllMessages retourneert een statische momentopname van de berichten in de wachtrij, niet dynamische koppelingen naar die berichten. Daarom kunt u de matrix niet gebruiken om de berichten in de wachtrij te wijzigen. Als u realtime dynamische interactie met de wachtrij wilt (zoals de mogelijkheid om berichten te verwijderen), roept u de GetMessageEnumerator2 methode aan die een dynamische lijst met berichten in de wachtrij retourneert.

Omdat GetAllMessages er een kopie wordt geretourneerd van de berichten in de wachtrij op het moment dat de methode werd aangeroepen, worden geen nieuwe berichten weergegeven die in de wachtrij binnenkomen of berichten die uit de wachtrij zijn verwijderd.

GetAllMessages haalt alleen deze eigenschappen op die niet zijn gefilterd door de MessageReadPropertyFilter eigenschap.

In de volgende tabel ziet u of deze methode beschikbaar is in verschillende werkgroepmodi.

Zie ook

• Message
• GetMessageEnumerator2()