MessageQueue.Purge Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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 par Message Queuing, ce qui affecte la LastModifyTime propriété . Les messages qui sont vidés de la file d’attente sont perdus ; elles ne sont pas envoyées à la file d’attente de lettres mortes ou à la file d’attente du journal.
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 |
Ordinateur local et nom de format direct | Oui |
Ordinateur distant | Non |
Ordinateur distant et nom de format direct | Oui |