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 屬性。 從佇列中清除的訊息會遺失;它們不會傳送至寄不出的信件佇列或日誌佇列。

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

工作組模式	可用
本機電腦	是
本機計算機和直接格式名稱	是
遠端電腦	否
遠端電腦和直接格式名稱	是

另請參閱

• Close()
• Refresh()