MessageQueue.Purge Methode

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Löscht alle in der Warteschlange enthaltenen Meldungen.

public:
 void Purge();

public void Purge ();

member this.Purge : unit -> unit

Public Sub Purge ()

Ausnahmen

MessageQueueException

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

Weitere Informationen

• Close()
• Refresh()