MessageQueue.Purge 方法

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

刪除佇列中所有訊息。

public:
 void Purge();

public void Purge();

member this.Purge : unit -> unit

Public Sub Purge ()

例外狀況

MessageQueueException

存取訊息佇列方法時發生錯誤。

範例

下列程式代碼範例示範 如何使用 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();

備註

清除佇列會讓訊息佇列設定隊列修改旗標，進而影響該 LastModifyTime 屬性。 從隊列中被清除的訊息會遺失;它們不會被送入死信佇列或日誌佇列。

下表顯示此方法是否可在多種工作群組模式中使用。

工作群組模式	有現貨
本機電腦	是的
本地電腦與直接格式名稱	是的
遠端電腦	No
遠端電腦與直接格式名稱	是的

另請參閱

• Close()
• Refresh()