MessageQueue.Purge Méthode

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Supprime tous les messages contenus dans la file d'attente.

public:
 void Purge();

public void Purge ();

member this.Purge : unit -> unit

Public Sub Purge ()

Exceptions

MessageQueueException

Une erreur s'est produite lors de l'accès à une méthode Message Queuing.

Exemples

L'exemple de code suivant montre l'utilisation 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();

Remarques

Le vidage de la file d’attente entraîne la définition de l’indicateur de modification de file d’attente, ce qui affecte la LastModifyTime propriété. Les messages vidés de la file d’attente sont perdus ; ils ne sont pas envoyés à la file d’attente de lettres mortes ou à la file d’attente de journaux.

Le tableau suivant indique si cette méthode est disponible dans différents modes de groupe de travail.

Mode groupe de travail	Disponible
Ordinateur local	Oui
Nom de l’ordinateur local et du format direct	Oui
Ordinateur distant	Non
Ordinateur distant et nom de format direct	Oui

Voir aussi

• Close()
• Refresh()