Comment : spécifier des propriétés à récupérer avec un message
Mise à jour : novembre 2007
Lorsque vous créez une instance du composant MessageQueue, vous pouvez définir une série de propriétés pour indiquer les propriétés que vous souhaitez récupérer lorsque le composant reçoit un message d'une file d'attente. Ces propriétés font partie d'une classe appelée MessagePropertyFilter et correspondent aux propriétés réelles de la classe Message. Lorsque vous affectez la valeur true à l'une de ces propriétés, le composant récupère la propriété correspondante chaque fois qu'un message est retiré d'une file d'attente.
.gif "Conseil") Conseil : |
|---|
Si vous n'avez pas besoin d'accéder à certaines propriétés de vos messages récupérés et que vous souhaitez améliorer les performances, vous pouvez affecter la valeur false à MessagePropertyFilter. |
Par défaut, les propriétés récupérées avec un message comprennent celles indiquant la date et l'heure d'envoi et d'arrivée, plusieurs identificateurs du message, son étiquette, la file d'attente de réponse ainsi que le corps du message.
Pour spécifier les propriétés à récupérer avec un message
Créez une instance du composant MessageQueue et affectez à sa propriété Path la file d'attente à laquelle vous voulez faire référence. Pour plus d'informations, consultez Comment : créer des instances du composant MessageQueue.
Dans la fenêtre Propriétés, développez le nœud MessageReadPropertyFilter.
Affectez la valeur true aux propriétés que vous souhaitez recevoir.
Remarque :Vous pouvez également définir celles-ci dans le code. Ainsi, vous pouvez utiliser la méthode SetAll pour affecter la valeur true à toutes les propriétés de filtre ou la méthode ClearAll pour affecter la valeur false à toutes les propriétés de filtre.
Voir aussi
Tâches
Comment : recevoir des messages par programme
Comment : recevoir des messages de manière asynchrone
Comment : créer des instances du composant MessageQueue