MessageQueue.Purge Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Odstraní všechny zprávy obsažené ve frontě.
public:
void Purge();
public void Purge ();
member this.Purge : unit -> unit
Public Sub Purge ()
Výjimky
Při přístupu k metodě služby Řízení front zpráv došlo k chybě.
Příklady
Následující příklad kódu ukazuje použití .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();
Poznámky
Vymazání fronty způsobí, že služba Řízení front zpráv nastaví příznak úpravy fronty, který má vliv na LastModifyTime vlastnost . Zprávy, které jsou vyprázdněné z fronty jsou ztraceny; nejsou odesílány do fronty nedoručených zpráv ani do fronty deníku.
Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.
Režim pracovní skupiny | K dispozici. |
---|---|
Místní počítač | Yes |
Název místního počítače a přímého formátu | Yes |
Vzdálený počítač | No |
Název vzdáleného počítače a přímého formátu | Yes |