MessageQueue.Purge Methode

Definition

Löscht alle in der Warteschlange enthaltenen Meldungen.

public:
 void Purge();
public void Purge ();
member this.Purge : unit -> unit
Public Sub Purge ()

Ausnahmen

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung von Purge.


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

// Delete all messages from the queue.
queue->Purge();

queue->Close();

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

// Delete all messages from the queue.
queue.Purge();

Hinweise

Das Bereinigen der Warteschlange bewirkt, dass Message Queuing das Warteschlangenänderungsflag festlegt, was sich auf die LastModifyTime -Eigenschaft auswirkt. Nachrichten, die aus der Warteschlange gelöscht werden, gehen verloren. sie werden nicht an die Warteschlange für unzustellbare Nachrichten oder die Journalwarteschlange gesendet.

Die folgende Tabelle zeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokalem Computer Ja
Name des lokalen Computers und direktes Format Ja
Remotecomputer Nein
Name des Remotecomputers und des direkten Formats Ja

Gilt für:

Weitere Informationen