Files d’attente Message Queuing
Cette section décrit la spécification de files d'attentes Microsoft Message Queuing (également appelé MSMQ) lors de l'utilisation de l'adaptateur MSMQ. Elle décrit les conventions utilisées lors de la spécification de chemins d'accès ainsi que le rôle joué par les noms de formats dans la conversion de chemins en désignations de file d'attente.
Conventions d'affectation de noms aux chemins des files d'attente
Lorsque le nom de la file d'attente fait référence à un chemin, utilisez les conventions d'affectation de noms décrites dans le tableau suivant.
| Type de file d'attente | Syntaxe du chemin |
|---|---|
| File d'attente publique | Computername\QueueName |
| File d'attente privée | Computername\Private$\QueueName |
| File d'attente du journal | Computername\QueueName\Journal$ |
| Note de la file d’attente du journal de l’ordinateur : utilisez uniquement pour la file d’attente de réception. | Computername\Journal$ |
| File d’attente de lettres mortes de l’ordinateur Remarque : utilisez uniquement pour la file d’attente de réception. | Computername\Deadletter$ |
| File d’attente de lettres mortes de transaction de l’ordinateur Remarque : utilisez uniquement pour la file d’attente de réception. | Computername\XactDeadletter$ |
Notes
Le chemin de la file d'attente doit être unique.
Lorsque le nom de la file d'attente fait référence à un nom de format, il prend la forme d'une chaîne qui indique si la file d'attente est publique ou privée, suivie par un GUID généré pour la file d'attente ainsi que par d'autres identificateurs, selon le besoin. Utilisez les conventions d'affectation de noms décrites dans le tableau suivant.
| Type de format | Syntaxe du nom de format |
|---|---|
| Public | FormatName:P ublic=QueueGUID |
| Direct | FormatName:D IRECT=SPX :NetworkNumber :HostNumber\QueueName FormatName : DIRECT=TCP :IPAddress\QueueName FormatName : DIRECT=OS :ComputerName\QueueName |
Si le chemin de la file d'attente du port d'envoi est une liste de distribution, sa syntaxe est la suivante :
DL=GUIDListeDistribution
Si le chemin de la file d'attente d'envoi ou de réception est une URL HTTP ou HTTPS, la syntaxe est la suivante :
FormatName :DIRECT=http ://<nom du> client/msmq/nom de file d’attente<>
FormatName :DIRECT=https ://<nom du> client/msmq/nom de file d’attente<>
Notes
« msmq » correspond au répertoire virtuel créé par Message Queuing dans IIS (Internet Information Services).
Notes
Vous pouvez uniquement utiliser le protocole HTTP pour envoyer des messages. Il est impossible de lire des messages dans une file d'attente située sur un ordinateur distant si celle-ci est ouverte à l'aide d'un nom de format direct HTTP. Toutefois, vous pouvez toujours recevoir des messages SOAP (formatés) à partir d'une file d'attente distante à l'aide du chemin de la file d'attente publique ou privée sans le protocole HTTP.
Si le nom de la file d'attente fait référence à un nom constitué de texte descriptif que l'administrateur a spécifié pour cette file d'attente, la syntaxe du chemin de file d'attente faisant référence à ce nom est la suivante :
LABEL:MyQueue
Notes
Les noms ne sont pas toujours uniques. Toutefois, vous recevrez une erreur s'il existe un conflit de noms lorsque vous tentez de vous connecter à une file d'attente spécifique à l'aide de son nom.
Notes
Le nom est un paramètre de champ de transport obligatoire pour l'adaptateur.
Rôle du nom de format
Le nom de format permet à Message Queuing d'identifier une file d'attente et de déterminer la manière d'y accéder. Message Queuing attribue le nom de format à la file d'attente.
Lorsque vous spécifiez une file d'attente à l'aide de la syntaxe du nom de chemin, par exemple myMachine\myQueue, Message Queuing recherche le chemin pour identifier le nom de format qui lui est associé. Message Queuing utilise ensuite ce nom de format pour accéder à la file d'attente. Lorsque vous spécifiez le nom de format, Message Queuing utilise celui que vous indiquez.
Pour plus d'informations sur les noms de formats, consultez la rubrique « Propriété MessageQueue.FormatName » dans l'aide de la bibliothèque de classes .NET Framework.
Résolution des problèmes relatifs aux chemins des files d'attente
Une exception se produit si la syntaxe du chemin de file d'attente renseigné ne correspond à aucun des formats décrits précédemment dans la partie « Conventions d'affectation de noms aux chemins des files d'attente ».
Les caractères suivants sont non valides pour la spécification du nom de l'ordinateur dans le chemin de file d'attente :
\ ; , + "
Une exception se produit si le nom d'un ordinateur est un nombre. Par exemple : 234\private$\queue.
Pour la file d'attente des messages non distribués de l'ordinateur, la file d'attente du journal de l'ordinateur et pour la file d'attente des messages non distribués des transactions de l'ordinateur, une exception se produit lorsqu'un utilisateur spécifie l'une des files d'attente du système comme file d'attente de destination pour l'envoi.
System.Messaging.MessageQueue.Exists ne fonctionne pas pour les files d’attente distantes. Pour plus d'informations, consultez la rubrique « Méthode MessageQueue.Exists » dans l'aide de la bibliothèque de classes .NET Framework.