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()

Gibt zurück

Ein Array vom Typ Message , das alle Nachrichten in der Warteschlange darstellt, in der gleichen Reihenfolge wie sie in der Warteschlange "Message Queuing" angezeigt werden.

Ausnahmen

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung von 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);
}

Hinweise

GetAllMessages gibt eine statische Momentaufnahme der Nachrichten in der Warteschlange zurück, nicht dynamische Links zu diesen Nachrichten. Daher können Sie das Array nicht verwenden, um die Nachrichten in der Warteschlange zu ändern. Wenn Sie echtzeitbasierte dynamische Interaktion mit der Warteschlange wünschen (z. B. die Möglichkeit zum Löschen von Nachrichten), rufen Sie die Methode auf, die GetMessageEnumerator2 eine dynamische Liste der Nachrichten in der Warteschlange zurückgibt.

Da GetAllMessages zum Zeitpunkt des Aufrufs der Methode eine Kopie der Nachrichten in der Warteschlange zurückgegeben wird, spiegelt das Array keine neuen Nachrichten wider, die in der Warteschlange oder nachrichten eingehen, die aus der Warteschlange entfernt werden.

GetAllMessages ruft nur diese Eigenschaften ab, die nicht von der MessageReadPropertyFilter Eigenschaft gefiltert werden.

In der folgenden Tabelle wird gezeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Weitere Informationen

• Message
• GetMessageEnumerator2()