Cette documentation est archivée et n’est pas conservée.

MessageQueue.GetMessageEnumerator2, méthode

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

Crée un objet énumérateur pour tous les messages figurant dans la file d'attente.

Espace de noms : System.Messaging
Assembly : System.Messaging (dans system.messaging.dll)

public MessageEnumerator GetMessageEnumerator2 ()
public MessageEnumerator GetMessageEnumerator2 ()
public function GetMessageEnumerator2 () : MessageEnumerator

Valeur de retour

MessageEnumerator contenant tous les messages de la file d'attente.

GetMessageEnumerator2 crée une liste dynamique de tous les messages disponibles dans la liste d'attente. Vous pouvez supprimer le message qui se trouve à la position actuelle de l'énumérateur dans la file d'attente en appelant RemoveCurrent pour le MessageEnumerator retourné par GetMessageEnumerator2.

Le curseur étant associé à la liste dynamique des messages de la file d'attente, l'énumération reflète toute modification apportée aux messages qui se trouvent au-delà de la position actuelle du curseur. Ainsi, l'énumérateur peut automatiquement accéder à un message de priorité moindre si ce dernier se trouve au-delà de la position actuelle du curseur. En revanche, il n'a pas accès aux messages de priorité plus élevée, insérés avant cette position. Vous pouvez toutefois réinitialiser cette énumération, et par conséquent placer le curseur en début de liste, en appelant Reset pour MessageEnumerator.

L'énumération ordonne les messages conformément à l'ordre utilisé dans la file d'attente et les messages d'une priorité plus élevée sont donc placés avant ceux dont la priorité est moindre.

Appelez GetAllMessages pour obtenir un instantané statique des messages de la file d'attente plutôt qu'une connexion dynamique avec ceux-ci. Cette méthode retourne un tableau d'objets Message qui représentent les messages disponibles dans la file au moment où la méthode est appelée.

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

Mode groupe de travail

Disponible

Ordinateur local

Oui

Ordinateur local et nom de format direct

Oui

Ordinateur distant

Oui

Ordinateur distant et nom de format direct

Oui

  • Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez .

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: