MessageQueue.GetMessageEnumerator Méthode

public:
 System::Messaging::MessageEnumerator ^ GetMessageEnumerator();

public System.Messaging.MessageEnumerator GetMessageEnumerator();

[System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")]
public System.Messaging.MessageEnumerator GetMessageEnumerator();

member this.GetMessageEnumerator : unit -> System.Messaging.MessageEnumerator

[<System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")>]
member this.GetMessageEnumerator : unit -> System.Messaging.MessageEnumerator

Public Function GetMessageEnumerator () As MessageEnumerator

Retours

MessageEnumerator Conservation des messages contenus dans la file d’attente.

Attributs

ObsoleteAttribute

Remarques

GetMessageEnumerator crée une liste dynamique de tous les messages d’une file d’attente. Vous pouvez supprimer de la file d’attente le message à la position actuelle de l’énumérateur en appelant RemoveCurrent pour le MessageEnumerator retour.GetMessageEnumerator

Étant donné que le curseur est associé à la liste dynamique des messages de la file d’attente, l’énumération reflète toute modification que vous apportez aux messages de la file d’attente, si le message dépasse la position actuelle du curseur. Par exemple, l’énumérateur peut accéder automatiquement à un message de priorité inférieure placé au-delà de la position actuelle du curseur, mais pas un message de priorité supérieure inséré avant cette position. Toutefois, vous pouvez réinitialiser l’énumération, en déplaçant ainsi le curseur vers le début de la liste, en appelant Reset pour le MessageEnumerator.

L’ordre des messages de l’énumération reflète leur ordre dans la file d’attente, de sorte que les messages de priorité supérieure apparaissent avant les messages de priorité inférieure.

Si vous souhaitez un instantané statique des messages dans la file d’attente plutôt qu’une connexion dynamique à ces messages, appelez GetAllMessages. Cette méthode retourne un tableau d’objets Message , qui représentent les messages au moment où la méthode a été appelée.

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

Voir aussi

• GetAllMessages()
• GetMessageEnumerator2()
• GetMessageQueueEnumerator()