MessageQueue.Purge Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht alle Nachrichten, die in der Warteschlange enthalten sind.
public:
void Purge();public void Purge();member this.Purge : unit -> unitPublic 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
Durch das Löschen der Warteschlange wird die Warteschlangenänderungskennzeichnung festgelegt, die sich auf die LastModifyTime Eigenschaft auswirkt. Nachrichten, die aus der Warteschlange gelöscht werden, gehen verloren; sie werden nicht an die Warteschleife oder die Journalwarteschlange gesendet.
In der folgenden Tabelle wird gezeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.
| Arbeitsgruppenmodus | Verfügbar |
|---|---|
| Lokaler Computer | Ja |
| Name des lokalen Computers und des direkten Formats | Ja |
| Remotecomputer | No |
| Name des Remotecomputers und des direkten Formats | Ja |
