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