Propriétés de configuration des files d'attente de messages
Mise à jour : novembre 2007
Vous pouvez manipuler un certain nombre de propriétés sur les files d'attente et les composants MessageQueue que vous créez. Vous pouvez définir ces propriétés pour vous aider à paramétrer des valeurs qui déterminent le comportement de la file d'attente ou exécuter une requête sur ces propriétés pour récupérer des informations sur une file d'attente avec laquelle votre composant interagit.
Propriétés qui référencent une file d'attente
Utilisez la propriété Path pour déterminer la file d'attente à laquelle votre composant fait référence. Trois possibilités s'offrent à vous pour identifier le chemin d'accès : le chemin d'accès physique de la file d'attente, le nom de format ou l'étiquette descriptive de celle-ci. Pour des explications détaillées sur les différences entre chemin d'accès, nom de format et étiquette, consultez Recommandations relatives aux références de files d'attente.
Les files d'attente peuvent également être classées par catégorie. Vous pouvez utiliser la propriété Category pour déterminer le type de file d'attente que vous utilisez. Category est un GUID qui est défini par le propriétaire de la file d'attente. Pour définir un identificateur GUID, vous pouvez soit utiliser l'outil de génération du GUID, soit créer votre propre numéro. Les GUID Category ne doivent pas être uniques sauf au sein d'une même catégorie. Vous pouvez par exemple définir la même catégorie pour toutes vos files d'attente de traitement des commandes. Ainsi, vous pouvez toutes les récupérer avec ce GUID.
Propriétés qui déterminent le type de données à envoyer
Vous utilisez la propriété Formatter pour déterminer comment le contenu de votre message sera sérialisé dans un message avant d'être envoyé à une file d'attente et comment il sera extrait d'un message après avoir été reçu dans une file d'attente. La définition de la propriété Formatter détermine le type de contenu que vous pouvez envoyer dans un message. Pour plus d'informations, consultez Sérialisation de messages.
Propriétés qui contrôlent l'interaction avec une file d'attente
Vous pouvez utiliser les propriétés suivantes pour contrôler l'interaction de votre composant avec une file d'attente :
Vous pouvez utiliser la propriété DenySharedReceive pour indiquer qu'un seul composant à la fois peut examiner les messages dans une file d'attente. Cela peut s'avérer très utile dans un environnement multi-utilisateur. Lorsque DenySharedReceive est activé, le premier composant qui lit des messages ou les reçoit d'une file d'attente est le seul composant autorisé à effectuer ces opérations à ce moment-là. Lorsque le premier composant termine son instance de cette file d'attente, il libère la file d'attente soit par une opération garbage collection, soit par l'appel de Close. Pour plus d'informations sur l'opération garbage collection, consultez Garbage collection.
Vous pouvez utiliser les propriétés CanRead et CanWrite pour déterminer si vous disposez d'un accès en lecture et en écriture sur une file d'attente particulière ou pour définir une file d'attente afin qu'elle autorise l'accès en lecture et en écriture.
Vous pouvez utiliser les propriétés MaximumQueueSize et MaximumJournalSize pour déterminer la capacité, en kilo-octets, de messages qu'une file d'attente peut recevoir. Dès que ce maximum est atteint, les messages ne sont plus acceptés par la file d'attente. Par défaut, la taille de file d'attente maximale reprend la valeur de la taille définie par l'administrateur système de Message Queuing. En l'absence d'une limite définie, la taille de la file d'attente est infinie.
Vous pouvez utiliser la propriété UseJournalQueue pour déterminer si les copies des messages récupérées de la file d'attente sont ajoutées au journal de file d'attente.
Voir aussi
Tâches
Comment : créer des instances du composant MessageQueue