MessageQueue.GetAllMessages-Methode

Artikel
08/20/2007

Gibt alle Meldungen in der Warteschlange zurück.

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public Function GetAllMessages As Message()
'Usage
Dim instance As MessageQueue
Dim returnValue As Message()

returnValue = instance.GetAllMessages

public Message[] GetAllMessages ()

public:
array<Message^>^ GetAllMessages ()

public Message[] GetAllMessages ()

public function GetAllMessages () : Message[]

Rückgabewert

Ein Array vom Typ Message, das alle Meldungen aus der Warteschlange darstellt. Die Reihenfolge entspricht der Reihenfolge in der Message Queuing-Warteschlange.

Ausnahmen

Ausnahmetyp	Bedingung
MessageQueueException	Fehler beim Zugriff auf eine Message Queuing-Methode.

Hinweise

GetAllMessages gibt keine dynamischen Verweise auf die Meldungen, sondern einen statischen Snapshot der Meldungen in der Warteschlange zurück. Sie können das Array daher nicht zum Ändern der Meldungen in der Warteschlange verwenden. Wenn Sie eine dynamische Echtzeitinteraktion mit der Warteschlange wünschen, bei der z. B. Meldungen gelöscht werden können, rufen Sie die GetMessageEnumerator2-Methode auf. Diese gibt eine dynamische Liste der Meldungen in der Warteschlange zurück.

Da GetAllMessages eine Kopie der Meldungen in der Warteschlange zum Zeitpunkt des Methodenaufrufs zurückgibt, werden in dem Array keine neu in die Warteschlange eingegangenen Meldungen oder aus der Warteschlange entfernten Meldungen wiedergegeben.

GetAllMessages ruft nur die Eigenschaften ab, die nicht von der MessageReadPropertyFilter-Eigenschaft ausgefiltert wurden.

Der folgenden Tabelle können Sie entnehmen, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokaler Computer	Ja
Lokaler Computer + direkter Formatname	Ja
Remotecomputer	Nein
Lokaler Computer + direkter Formatname	Ja

Beispiel

Im folgenden Codebeispiel wird die Verwendung von GetAllMessages veranschaulicht.

// 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);
}

// 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.
for (int iCtr = 0; iCtr < msgs.length; iCtr++) {
    Message msg = msgs[iCtr];
    // Display the label of each message.
    Console.WriteLine(msg.get_Label());
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

MessageQueue-Klasse
MessageQueue-Member
System.Messaging-Namespace
Message-Klasse
GetMessageEnumerator2

Freigeben über