MessageQueue.Purge Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Usuwa wszystkie komunikaty zawarte w kolejce.
public:
void Purge();
public void Purge ();
member this.Purge : unit -> unit
Public Sub Purge ()
Wyjątki
Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.
Przykłady
W poniższym przykładzie kodu pokazano użycie metody 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();
Uwagi
Przeczyszczenie kolejki powoduje, że kolejkowanie komunikatów powoduje ustawienie flagi modyfikacji kolejki, która wpływa na LastModifyTime właściwość. Komunikaty przeczyszczane z kolejki są utracone; nie są wysyłane do kolejki utraconych wiadomości ani do kolejki dziennika.
W poniższej tabeli przedstawiono, czy ta metoda jest dostępna w różnych trybach grupy roboczej.
Tryb grupy roboczej | Dostępne |
---|---|
Komputer lokalny | Tak |
Komputer lokalny i nazwa formatu bezpośredniego | Tak |
Komputer zdalny | Nie |
Nazwa komputera zdalnego i formatu bezpośredniego | Tak |