Comment : créer des instances du composant MessageQueue

Mise à jour : novembre 2007

Vous créez des composants MessageQueue lorsque vous souhaitez intégrer des fonctionnalités de messagerie dans votre application. Les composants MessageQueue permettent d'établir une connexion aux files d'attente existantes, l'envoi et la réception de messages, et enfin l'ajout de services de communication à votre application à l'aide d'une petite quantité de code. Supposons, par exemple, que vous élaboriez un système de saisie de commandes qui place ces commandes dans des files d'attente à mesure qu'il les reçoit des vendeurs ou directement des clients qui commandent sur un site Web. Vous pouvez commencer par ajouter une instance du composant MessageQueue à votre projet et le configurer afin qu'il interagisse avec une file d'attente OrderEntry existante de votre serveur Message Queuing.

Vous pouvez ajouter une instance du composant MessageQueue aux Windows Forms, aux Web Forms et aux classes de composants. Les composants MessageQueue ne sont pas dotés d'interface utilisateur visuelle. Si vous ajoutez une instance du composant MessageQueue à un concepteur visuel (tel que le Concepteur Windows Forms), le composant apparaît dans une petite zone située sous le bord inférieur du formulaire. Cette zone porte le nom de barre d'état des composants et sert d'emplacement d'affichage pour tous les éléments non visuels associés à ce formulaire.

Remarque :
Les classes non visuelles qui héritent de Component prennent en charge une aire de conception visuelle, similaire à la barre d'état des composants, dans laquelle sont disposés votre composant MessageQueue et d'autres composants. La disposition des éléments dans ce concepteur est sans importance, car l'interface affichée ne sera jamais vue par les utilisateurs finals de l'application.

Pour les instructions sur la configuration des composants MessageQueue, consultez Propriétés de configuration des files d'attente de messages.

Il existe différentes façons de créer une instance du composant MessageQueue :

• Vous pouvez faire glisser une instance du composant MessageQueue de l'onglet Composants de la Boîte à outils vers un formulaire ou le Concepteur de composants.

• Vous pouvez rechercher la file d'attente souhaitée dans l'Explorateur de serveurs et l'ajouter à votre concepteur, en créant ainsi une instance du composant MessageQueue préconfigurée pour pointer vers cette file d'attente.

• Vous pouvez créer une instance du composant MessageQueue dans le code.

Pour créer une instance du composant MessageQueue à partir de la Boîte à outils

1. Cliquez sur l'onglet Composants de la Boîte à outils.

2. Sélectionnez l'icône MessageQueue et faites-la glisser jusqu'à l'aire de conception de votre formulaire ou composant.

3. Configurez votre composant. Pour plus d'informations, consultez Propriétés de configuration des files d'attente de messages.

Pour créer une instance du composant MessageQueue à partir de l'Explorateur de serveurs

1. Ouvrez l'Explorateur de serveurs. Pour plus d'informations, consultez Comment : accéder à l'Explorateur de serveurs/bases de données et l'initialiser.

2. Développez le nœud Serveurs et voyez si ce nœud affiche le serveur qui héberge la file d'attente requise.

   Conseil :
   Si le serveur que vous voulez voir ne figure pas dans la liste, vous devez l'ajouter. Pour plus d'informations, consultez Comment : accéder à l'Explorateur de serveurs/bases de données et l'initialiser.

3. Développez le nœud du serveur que vous voulez afficher ; ensuite recherchez et développez le nœud Files d'attente de messages sous celui-ci.

   Remarque :
   Si vous ne parvenez pas à développer le nœud Files d'attente de messages, cela signifie que Message Queuing n'est pas installé sur l'ordinateur dont vous tentez de visualiser les files d'attente. Pour obtenir des informations sur l'installation et la configuration de Message Queuing, consultez la documentation Message Queuing de Windows 2000 ou Windows NT.

4. Recherchez la file d'attente à ajouter à votre projet et cliquez dessus avec le bouton droit.

5. Cliquez sur Ajouter au Concepteur.

6. Configurez votre composant. Pour plus d'informations, consultez Propriétés de configuration des files d'attente de messages.

Pour créer une instance du composant MessageQueue par programme

1. Créez une instance de la classe MessageQueue dans le code et définissez Path pour déterminer la file d'attente existante à laquelle vous souhaitez que votre composant fasse référence. Votre code se présente comme suit :

   Dim myMQ As New System.Messaging.MessageQueue()
   myMQ.Path = ".\MyNewQueue"
   

        System.Messaging.MessageQueue myMQ =
              new System.Messaging.MessageQueue();
           myMQ.Path = @".\MyNewQueue";
   

   Conseil :
   Vous pouvez combiner les étapes un et deux en une seule, en utilisant ce format :

   Dim myMQ2 As New System.Messaging.MessageQueue(".\MyNewQueue")
   

        System.Messaging.MessageQueue myMQ2 =
              new System.Messaging.MessageQueue(@".\MyNewQueue");
   

   Remarque :
   Vous pouvez faire référence à la file d'attente par son chemin d'accès, par son nom de format automatiquement généré ou par son étiquette descriptive et non unique. Chacune de ces méthodes comporte ses avantages et ses inconvénients. Pour plus d'informations, consultez Recommandations relatives aux références de files d'attente.

2. Configurez toutes les autres propriétés nécessaires à votre file d'attente. Pour plus d'informations, consultez Propriétés de configuration des files d'attente de messages.

Voir aussi

Concepts

Propriétés de configuration des files d'attente de messages

Référence

Comment : accéder à l'Explorateur de serveurs/bases de données et l'initialiser