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()