MessageQueue.Purge Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Apaga todas as mensagens contidas na fila.
public:
void Purge();
public void Purge();
member this.Purge : unit -> unit
Public Sub Purge ()
Exceções
Ocorreu um erro ao aceder a um método de Fila de Mensagens.
Exemplos
O exemplo de código a seguir demonstra o uso de 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();
Observações
Purgar a fila faz com que a Fila de Mensagens defina a bandeira de modificação da fila, o que afeta a LastModifyTime propriedade. As mensagens que são eliminadas da fila são perdidas; não são enviados para a fila de cartas mortas nem para a fila de diários.
A tabela seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.
| Modo de grupo de trabalho | Available |
|---|---|
| Computador local | Yes |
| Computador local e nome do formato direto | Yes |
| Computador remoto | No |
| Computador remoto e nome do formato direto | Yes |