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
Przeczyszczanie 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ą tracone; nie są one 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ępny |
|---|---|
| Komputer lokalny | Yes |
| Nazwa komputera lokalnego i bezpośredniego formatu | Yes |
| Komputer zdalny | Nie. |
| Nazwa komputera zdalnego i bezpośredniego formatu | Yes |