Collections de messages et de files d'attente
Mise à jour : novembre 2007
Vous pouvez récupérer des listes des files d'attente de votre réseau Message Queuing et les messages qu'elles contiennent à l'aide d'une des nombreuses méthodes de récupération disponibles dans la classe MessageQueue. Vous pouvez récupérer des listes de files d'attente et de messages si vous souhaitez effectuer des tâches administratives, générer des états sur le contenu des files d'attente ou rechercher dans le contenu d'une file d'attente des messages qui répondent à des critères spécifiques.
Pour la récupération des messages et des files d'attente, deux possibilités s'offrent à vous : vous pouvez récupérer un instantané statique des messages ou files d'attente du réseau ou vous pouvez utiliser un énumérateur pour parcourir les messages et les files d'attente. La récupération d'une liste statique de files d'attente ou de messages est plus rapide que celle d'une énumération sans toutefois offrir la même exactitude ou contrôle sur les informations résultantes. Vous pouvez utiliser un instantané statique de la récupération lorsque vous devez effectuer une tâche administrative sur toutes les files d'attente de votre réseau.
Les énumérateurs vous offrent un plus grand contrôle au niveau de l'interaction avec les résultats récupérés. À l'aide d'un énumérateur, vous pouvez localiser une file d'attente ou un message répondant à certains critères plutôt qu'évaluer chacun des éléments de la collection retournée. Vous pouvez, par exemple, avoir recours à un énumérateur si vous souhaitez examiner le contenu d'une file d'attente et ne manipuler que les messages dont une propriété spécifique a la valeur true.
Récupération de files d'attente de messages
Il est possible de récupérer des informations sur les files d'attente de diverses façons :
Vous pouvez récupérer un tableau statique de toutes les files d'attente publiques et privées du réseau.
Vous pouvez récupérer un sous-ensemble statique de toutes les files d'attente publiques du réseau en spécifiant certains critères comme la date et l'heure de création ou de modification de la file d'attente, en indiquant une catégorie, une étiquette ou l'ordinateur à utiliser pour récupérer les files d'attente.
Vous pouvez parcourir les files d'attente du réseau à l'aide d'un énumérateur ou parcourir un sous-ensemble de toutes les files d'attente du réseau en spécifiant des critères tels que le nom de l'ordinateur, la date et l'heure de création et la catégorie.
Il est également possible d'avoir recours à la méthode Exists pour déterminer si une file d'attente qui vous intéresse existe. La méthode Exists recherche une file d'attente spécifique selon le chemin d'accès que vous définissez.
Pour obtenir des instructions sur la récupération des listes de files d'attente de messages, consultez Comment : récupérer des files d'attente.
Récupération de messages
Lorsque vous récupérez des messages dans un tableau ou un énumérateur, vous ne retirez pas réellement ces messages de la file d'attente comme c'est le cas avec la lecture ou la réception de messages. En réalité, vous récupérez des informations sur les éléments de la file d'attente, tandis que les messages eux-mêmes restent disponibles pour les utilisateurs auxquels ils sont destinés.
Il est possible de récupérer des messages de plusieurs façons :
Vous pouvez récupérer un tableau statique de tous les messages d'une file d'attente.
Vous pouvez parcourir les messages d'une file d'attente à l'aide d'un énumérateur.
Pour obtenir des instructions sur la récupération de listes de messages, consultez Comment : récupérer des messages.
Utilisation des éléments d'un énumérateur
Après avoir créé une énumération de messages ou de files d'attente, l'énumérateur est théoriquement placé avant le premier élément de l'énumération. Vous pouvez appeler la méthode MoveNext pour vous placer sur le premier élément de la liste et ensuite accéder aux éléments suivants. Il est par ailleurs possible d'utiliser la méthode Current pour retourner l'élément sur lequel vous êtes actuellement placé dans l'énumération.