Comment : envoyer des messages simples

Mise à jour : novembre 2007

À l'aide d'une instance du composant MessageQueue, vous pouvez envoyer des messages simples à une file d'attente dans simplement deux lignes de code. Lorsque vous envoyez un message simple, vous devez procéder comme suit :

• Créez une connexion avec la file d'attente à laquelle vous souhaitez envoyer un message.

• Spécifiez le formateur approprié pour les données à envoyer. Le formateur contrôle le type de données qu'il est possible d'envoyer dans un message et le type de persistance de ces données. Pour les messages simples, vous pouvez utiliser le formateur par défaut. Pour plus d'informations, consultez Sérialisation de messages.

• Appelez la méthode Send, qui passe l'objet à envoyer.

Création d'une connexion à la file d'attente

Après avoir déterminé la file d'attente avec laquelle vous souhaitez communiquer, vous devez créer une instance du composant MessageQueue qui fait référence à la file d'attente à utiliser. Vous pouvez créer ce composant à partir de la Boîte à outils, à partir de l'Explorateur de serveurs dans votre projet ou en utilisant le constructeur MessageQueue.

Pour créer une connexion à la file d'attente avec laquelle vous souhaitez communiquer

1. Créez une instance du composant MessageQueue. Pour plus d'informations, consultez Comment : créer des instances du composant MessageQueue.

2. Utilisez la propriété Path du composant pour vous connecter à la file d'attente avec laquelle vous souhaitez communiquer par le chemin d'accès, le nom de format ou l'étiquette.

   Remarque :
   Si vous avez créé votre composant à partir de l'Explorateur de serveurs, la propriété Path prend automatiquement comme valeur le chemin d'accès de cette file d'attente.

Indication des données à envoyer

Chaque composant MessageQueue comprend une série de propriétés par défaut qui sont appliquées à tous les messages envoyés par ce composant, sauf indication contraire dans un message de votre part. Dans le scénario le plus simple, vous pouvez envoyer un message simple à une file d'attente à l'aide des propriétés par défaut définies pour le composant. Pour plus d'informations sur ces propriétés, consultez Propriétés des messages par défaut.

Utilisez la méthode Send pour spécifier un message et l'envoyer à la file d'attente. Vous pouvez envoyer des objets, des types de données primitifs, des flux et d'autres données dans un message simple.

Le composant MessageQueue prend les données que vous spécifiez dans l'argument de la méthode Send, les rend persistantes dans un message et envoie le message à la file d'attente spécifiée.

Remarque :
Vous pouvez également utiliser l'objet Message pour envoyer des messages beaucoup plus complexes à une file d'attente. En outre, vous pouvez envoyer plusieurs messages dans une seule transaction. Pour plus d'informations, consultez Comment : envoyer des messages complexes.

Pour envoyer un message simple

• Dans la fenêtre Propriétés de votre composant MessageQueue, acceptez la valeur par défaut de Formatter ou affectez la valeur XmlMessageFormatter à la propriété si vous avez modifié la valeur par défaut.

  Utilisez la méthode Send pour envoyer un message simple à votre file d'attente, en spécifiant le message comme argument de la méthode.

  ' Create a connection to the queue.
  Dim MessageQueue1 As New System.Messaging.MessageQueue(".\YourQueue")
  ' Send an integer.
  MessageQueue1.Send(1)
  ' Send a string.
  MessageQueue1.Send("Hello world")
  

       // Create a connection to the queue.
          System.Messaging.MessageQueue mq =
             new System.Messaging.MessageQueue(@".\YourQueue");
          // Send an integer.
          mq.Send(1);
          // Send a string.
          mq.Send("Hello world");
  

  Cet exemple de code est également disponible sous forme d'extrait de code IntelliSense. Dans le sélecteur d'extraits de code, il se trouve dans Système d'exploitation Windows > Files d'attente de messages. Pour plus d'informations, consultez Comment : insérer des extraits de code dans votre code (Visual Basic).

Voir aussi

Tâches

Comment : créer des instances du composant MessageQueue

Comment : envoyer des messages complexes

Comment : vérifier des messages au moment du design

Concepts

Traitement transactionnel des messages

Autres ressources

Envoi et sérialisation de messages