Partager via


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.

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

  1. 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.

  2. Dans la fenêtre Propriétés, développez le nœud MessageReadPropertyFilter.

  3. 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 : lire des messages

Comment : recevoir des messages de manière asynchrone

Comment : créer des instances du composant MessageQueue

Autres ressources

Lecture et réception de messages