MessageQueue.Purge 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
删除队列中包含的所有消息。
public:
void Purge();
public void Purge();
member this.Purge : unit -> unit
Public Sub Purge ()
例外
访问消息队列方法时出错。
示例
下面的代码示例演示了如何使用 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 该属性。 从队列中清除的消息将丢失;它们不会发送到死信队列或日记队列。
下表显示了此方法在各种工作组模式下是否可用。
| 工作组模式 | 可用 |
|---|---|
| 本地计算机 | 是的 |
| 本地计算机和直接格式名称 | 是的 |
| 远程计算机 | 否 |
| 远程计算机和直接格式名称 | 是的 |