Partager via


Comment : créer des files d'attente

Mise à jour : novembre 2007

Vous pouvez créer une file d'attente pour fournir une ressource avec laquelle vos composants de messagerie peuvent interagir. 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 créer une file d'attente OrderEntry dans votre entreprise Message Queuing. Tous les composants que vous créez pour traiter les commandes interagiront avec cette file d'attente.

Vous pouvez créer une file d'attente de deux façons : en utilisant la fenêtre de l'Explorateur de serveurs ou en recourant au constructeur Create à partir de votre code. Vous pouvez utiliser l'Explorateur de serveurs ou la fenêtre Gestion de l'ordinateur de Windows 2000 pour vérifier si la création de votre file d'attente a réussi.

Vous pouvez créer une file d'attente publique sur votre propre ordinateur ou tout ordinateur Message Queuing pour lequel vous disposez de droits d'accès administratifs d'entreprise ou de domaine. Il est également possible de créer des files d'attente privées sur votre ordinateur local uniquement. Pour plus d'informations sur les droits d'accès, consultez Sécurité des files d'attente de messages ou « Contrôle d'accès pour Message Queuing » dans la documentation relative à la fenêtre Gestion de l'ordinateur.

Remarque :

Il est important de souligner la différence entre la création d'une file d'attente et la création d'une instance du composant MessageQueue. Lorsque vous utilisez la méthode Create, vous créez une nouvelle file d'attente dans le réseau Message Queuing, plutôt qu'un composant dans votre projet ou application. Lorsque vous créez une instance du composant MessageQueue, vous créez un composant à l'intérieur de votre projet qui fait référence à une file d'attente existant dans le système d'exploitation.

Vous pouvez également configurer un composant d'installation pour créer ou localiser une file d'attente existante lors du déploiement de votre application. Pour plus d'informations, consultez Gestion des actions personnalisées lors d'un déploiement.

Pour créer une file d'attente à partir de l'Explorateur de serveurs

  1. Ouvrez l'Explorateur de serveurs et accédez au serveur sur lequel vous souhaitez créer une file d'attente. Pour plus d'informations, consultez Comment : accéder à l'Explorateur de serveurs/bases de données et l'initialiser.

    Lorsque vous ajoutez une instance du composant MessageQueue à votre projet Visual Studio, le système crée automatiquement les références et importe les instructions dont vous avez besoin pour accéder à ces espaces de noms et à ces classes.

  2. Cliquez avec le bouton droit sur le nœud Files d'attente de messages.

  3. Cliquez avec le bouton droit sur Files d'attente publiques ou sur Files d'attente privées, selon le type de file d'attente à créer, puis cliquez sur Créer une file d'attente.

  4. Dans la boîte de dialogue Créer une file d'attente des messages, tapez le nom de votre file d'attente.

  5. S'il doit s'agir d'une file d'attente transactionnelle, sélectionnez Créer une file d'attente transactionnelle. Pour plus d'informations, consultez Traitement transactionnel des messages.

    Remarque :

    La création d'une file d'attente de messages publique peut prendre plus longtemps que prévu si le domaine est grand et qu'il contient de nombreux contrôleurs de domaine. Cela s'explique par le temps requis pour que la nouvelle file d'attente soit répliquée du contrôleur de domaine de votre ordinateur sur tous les autres contrôleurs de domaine du domaine. Vous pouvez rencontrer un retard au cours du processus de réplication.

Pour créer une file d'attente publique par programme

  1. Cliquez avec le bouton droit sur le projet, puis sélectionnez Ajouter une référence. Ajoutez une référence à System.Messaging.dll.

  2. Utilisez la méthode Create pour créer une file d'attente publique sur votre ordinateur. Votre code doit se présenter comme suit :

    System.Messaging.MessageQueue.Create("myMachine\MyQueue")
    
         System.Messaging.MessageQueue.Create(@"myMachine\MyQueue");
    
    Conseil :

    Vous pouvez utiliser une surcharge de la méthode Create pour indiquer que vous souhaitez créer une file d'attente transactionnelle. Vous pouvez aussi utiliser un point (.) dans le chemin d'accès pour indiquer l'ordinateur local.

    Note de sécurité :

    Sachez, lorsque vous créez une file d'attente de messages, que la ressource peut déjà exister. Il est possible qu'un autre processus, peut-être nuisible, ait déjà créé la ressource et puisse y accéder. Lorsque vous placez des données dans la file d'attente de messages, elles sont disponibles pour les autres processus. Pour plus d'informations sur les files d'attente existantes, consultez Comment : récupérer des files d'attente.

Pour créer une file d'attente privée par programme

  • Utilisez la méthode Create en spécifiant la syntaxe requise, Private$, pour créer une file d'attente privée sur votre ordinateur. Votre code doit se présenter comme suit :

    System.Messaging.MessageQueue.Create(".\Private$\MyPrivateQueue")
    
         System.Messaging.MessageQueue.Create(@".\Private$\MyPrivateQueue");
    

    Vous pouvez utiliser l'Explorateur de serveurs ou la fenêtre Gestion de l'ordinateur de Windows 2000 pour vérifier si votre file d'attente de messages a été créée.

Pour vérifier si votre file d'attente de messages a été créée

  • Dans l'Explorateur de serveurs, actualisez le nœud Files d'attente de messages en cliquant avec le bouton droit sur Files d'attente, puis en cliquant sur Actualiser. Un certain délai peut s'écouler avant que la file d'attente n'apparaisse.

    - ou -

  • Pour afficher des informations sur la mise en file d'attente des messages dans Windows 2000, procédez comme suit :

    1. Cliquez avec le bouton droit sur Poste de travail sur le Bureau, puis cliquez sur Gérer.

    2. Dans la boîte de dialogue qui s'affiche, développez le nœud Services et applications, puis développez Message Queuing. Votre file d'attente et les messages qu'elle contient figurent dans ce nœud.

Voir aussi

Tâches

Comment : créer des instances du composant MessageQueue

Autres ressources

Création, suppression et administration des files d'attente