Exporter (0) Imprimer
Développer tout
Développer Réduire

System.Messaging, espace de noms

L'espace de noms System.Messaging fournit des classes qui vous permettent de vous connecter aux files d'attente de messages, de les analyser et de les gérer sur le réseau, ainsi que d'envoyer, de recevoir ou de lire des messages.

Les membres de la classe MessageQueue incluent les méthodes mentionnées ci-dessous pour la lecture et l'écriture des messages dans la file d'attente.

  • La méthode Send permet à votre application d'écrire des messages dans la file d'attente. Les surcharges de la méthode vous permettent de spécifier si votre message doit être envoyé à l'aide de Message (qui fournit un contrôle détaillé sur les informations que vous envoyez) ou à l'aide de n'importe quel autre objet managé, y compris les classes spécifiques aux applications. La méthode prend également en charge l'envoi de messages dans le cadre d'une transaction.

  • Les méthodes Receive, ReceiveById et ReceiveByCorrelationId fournissent des fonctionnalités pour lire les messages à partir d'une file d'attente. Comme la méthode Send, ces méthodes fournissent des surcharges qui prennent en charge le traitement transactionnel des files d'attente. Ces méthodes fournissent aux surcharges un délai d'attente.

    Paramètres out qui permettent la poursuite du traitement si la file d'attente est vide. Dans la mesure où ces méthodes sont des exemples de traitement synchrone, elles interrompent le thread en cours jusqu'à ce qu'un message soit disponible, à moins qu'un délai d'attente ne soit spécifié.

  • La méthode Peek est semblable à Receive, mais elle n'entraîne pas la suppression d'un message de la file d'attente lorsque celui-ci est lu. Dans la mesure où Peek ne modifie pas le contenu de la file d'attente, il n'existe pas de surcharge pour prendre en charge le traitement transactionnel. Cependant, dans la mesure où Peek, comme Receive, lit les messages de manière synchrone à partir de la file d'attente, les surcharges de la méthode prennent en charge la spécification d'un délai d'attente afin d'éviter que le thread n'attende indéfiniment.

  • Les méthodes BeginPeek, EndPeek, BeginReceive et EndReceive permettent de lire des messages de manière asynchrone à partir de la file d'attente. Elles n'interrompent pas le thread en cours pendant l'attente de l'arrivée d'un message dans la file d'attente.

Les méthodes suivantes de la classe MessageQueue fournissent des fonctionnalités permettant de récupérer des listes de files d'attente en fonction de critères spécifiés et de déterminer si des files d'attente spécifiques existent.

Les autres méthodes de la classe MessageQueue offrent les fonctionnalités suivantes :

  • Création et suppression de files d'attente de Mise en file d'attente de messages.

  • Utilisation d'un énumérateur de message pour parcourir les messages d'une file d'attente.

  • Utilisation d'un énumérateur de file d'attente pour une itération dans les files d'attente du système.

  • Définition de droits d'accès basés sur ACL.

  • Utilisation du cache de connexion.

La classe Message fournit un contrôle détaillé des informations que vous envoyez à une file d'attente et est l'objet utilisé lors de la réception ou de la lecture de messages à partir d'une file d'attente. Outre le corps du message, les propriétés de la classe Message incluent des paramètres d'accusé de réception, des informations sur la sélection d'un formateur, l'identification, l'authentification et le chiffrement, des horodatages, des indications sur l'utilisation du traçage, l'enregistrement dans un journal serveur, les files d'attente de lettres mortes et les données de transaction.

Le composant MessageQueue est associé aux trois formateurs suivants qui vous permettent de sérialiser et de désérialiser les messages à destination et en provenance des files d'attente :

  • XmlMessageFormatter fournit une messagerie faiblement couplée, permettant le versioning indépendant de types sérialisés sur le client et le serveur.

  • ActiveXMessageFormatter est compatible avec le contrôle COM MSMQ. Vous pouvez ainsi d'une part envoyer des types qui peuvent être reçus par le contrôle et recevoir d'autre part des types envoyés par le contrôle.

  • BinaryMessageFormatter fournit une alternative plus rapide à XmlMessageFormatter, mais sans l'avantage de la messagerie faiblement couplée.

D'autres classes de l'espace de noms Messaging prennent en charge la sécurité d'accès du code et la sécurité basée sur les ACL, le filtrage des propriétés Message lors de la lecture de messages à partir d'une file d'attente, ainsi que l'utilisation de transactions pendant l'envoi et la réception de messages.

 ClasseDescription
Classe publiqueAccessControlEntrySpécifie les droits d'accès d'un tiers de confiance (utilisateur, groupe ou ordinateur) pour effectuer des implémentations de tâches courantes spécifiques aux applications.
Classe publiqueAccessControlListContient une liste d'entrées du contrôle d'accès, qui spécifie les droits d'accès d'un ou de plusieurs tiers de confiance.
Classe publiqueActiveXMessageFormatterSérialise ou désérialise les types de données primitifs ainsi que d'autres objets à destination ou en provenance du corps d'un message Message Queuing, à l'aide d'un format qui est compatible avec le composant ActiveX MSMQ.
Classe publiqueBinaryMessageFormatterSérialise ou désérialise un objet ou l'intégralité d'un graphique d'objets connectés, à destination ou en provenance d'un message Message Queuing, en utilisant un format binaire.
Classe publiqueCursorCursor est utilisé pour conserver un emplacement spécifique dans MessageQueue lors de la lecture des messages de la file d'attente.
Classe publiqueDefaultPropertiesToSendSpécifie les valeurs par défaut des propriétés qui seront utilisées lors de l'envoi d'objets autres que les instances Message à une file d'attente de messages.
Classe publiqueMessageFournit l'accès aux propriétés nécessaires à la définition d'un message de Message Queuing.
Classe publiqueMessageEnumeratorFournit un curseur avant uniquement pour l'énumération de messages dans une file d'attente.
Classe publiqueMessagePropertyFilterContrôle et sélectionne les propriétés qui sont récupérés lors de la lecture ou de la réception de messages d'une file d'attente de messages.
Classe publiqueMessageQueuePermet d'accéder à une file d'attente sur un serveur Message Queuing.
Classe publiqueMessageQueueAccessControlEntrySpécifie les droits d'accès d'un tiers de confiance (utilisateur individuel, groupe d'utilisateurs ou ordinateur) pour effectuer des tâches Message Queuing.
Classe publiqueMessageQueueCriteriaFiltre les files d'attente de messages lors d'une requête effectuée à l'aide de la méthode GetPublicQueues de la classe MessageQueue.
Classe publiqueMessageQueueEnumeratorFournit un curseur avant uniquement pour l'énumération de messages dans une file d'attente.
Classe publiqueMessageQueueExceptionException levée lorsqu'une erreur interne Microsoft Message Queuing se produit.
Classe publiqueMessageQueueInstallerVous permet d'installer et de configurer une file d'attente nécessaire à l'exécution de votre application. Cette classe est appelée par l'utilitaire d'installation, par exemple InstallUtil.exe, lors de l'installation de MessageQueue.
Classe publiqueMessageQueuePermissionPermet de contrôler les autorisations d'accès du code pour la messagerie.
Classe publiqueMessageQueuePermissionAttributePermet de vérifier l'autorisation MessageQueue déclarative.
Classe publiqueMessageQueuePermissionEntryDéfinit la plus petite unité d'une autorisation de sécurité d'accès du code définie pour la messagerie.
Classe publiqueMessageQueuePermissionEntryCollectionContient une collection fortement typée d'objets MessageQueuePermissionEntry.
Classe publiqueMessageQueueTransactionFournit une transaction Message Queuing interne.
Classe publiqueMessagingDescriptionAttributeSpécifie la description d'une propriété ou d'un événement.
Classe publiquePeekCompletedEventArgsFournit des données pour l'événement PeekCompleted. Lorsque votre opération de lecture asynchrone appelle un gestionnaire d'événements, une instance de cette classe est passée au gestionnaire.
Classe publiqueReceiveCompletedEventArgsFournit des données pour l'événement ReceiveCompleted. Lorsque votre opération de réception asynchrone appelle un gestionnaire d'événements, une instance de cette classe est passée au gestionnaire.
Classe publiqueSecurityContextReprésente le contexte de sécurité d'un message dans une file d'attente.
Classe publiqueTrusteeSpécifie un compte d'utilisateur, un compte de groupe ou une ouverture de session auquel s'applique une entrée du contrôle d'accès.
Classe publiqueXmlMessageFormatterSérialise et désérialise des objets de/vers le corps d'un message à l'aide du format XML, en se basant sur la définition de schéma XSD.

 InterfaceDescription
Interface publiqueIMessageFormatterSérialise ou désérialise des objets du corps d'un message Message Queuing.

 DéléguéDescription
Délégué publicPeekCompletedEventHandlerReprésente la méthode qui gérera l'événement PeekCompleted de MessageQueue.
Délégué publicReceiveCompletedEventHandlerReprésente la méthode qui gérera l'événement ReceiveCompleted de MessageQueue.

 ÉnumérationDescription
Énumération publiqueAccessControlEntryTypeSpécifie si les droits d'accès d'un tiers de confiance doivent être accordés, refusés ou révoqués.
Énumération publiqueAcknowledgeTypesSpécifie les types de message d'accusé de réception que Message Queuing retourne à l'application émettrice.
Énumération publiqueAcknowledgmentSpécifie le résultat d'une tentative de remise de message.
Énumération publiqueCryptographicProviderTypeSpécifie les fournisseurs de services de chiffrement disponibles pour la validation de signatures numériques.
Énumération publiqueEncryptionAlgorithmSpécifie l'algorithme de chiffrement utilisé pour chiffrer le corps d'un message privé.
Énumération publiqueEncryptionRequiredSpécifie le niveau de confidentialité des messages reçus par la file d'attente.
Énumération publiqueGenericAccessRightsUtilise le format d'accès de Windows 2000 et Windows NT pour spécifier un ensemble de droits d'accès communs que Message Queuing associe à des droits d'accès standard et spécifiques aux objets pour la lecture, l'écriture et l'exécution.
Énumération publiqueHashAlgorithmSpécifie l'algorithme de hachage utilisé par Message Queuing lors de l'authentification de messages.
Énumération publiqueMessageLookupActionSpécifie un message à lire ou à recevoir d'une file d'attente de messages.
Énumération publiqueMessagePrioritySpécifie la priorité que Message Queuing applique à un message lors de son routage vers une file d'attente et lors de son insertion dans la file d'attente de destination.
Énumération publiqueMessageQueueAccessRightsSpécifie un ensemble de droits d'accès spécifiques à un objet pour des opérations propres à Message Queuing.
Énumération publiqueMessageQueueErrorCodeIdentifie la source d'une erreur qui s'est produite dans l'application Message Queuing et qui a généré une exception MessageQueueException.
Énumération publiqueMessageQueuePermissionAccessDéfinit les niveaux d'accès employés par les classes d'autorisation System.Messaging.
Énumération publiqueMessageQueueTransactionStatusSpécifie l'état d'une transaction interne de Message Queuing.
Énumération publiqueMessageQueueTransactionTypeSpécifie le type d'une transaction Message Queuing.
Énumération publiqueMessageTypeIdentifie le type d'un message. Un message peut être un message "Message Queuing" standard, un accusé de réception positif (arrivée et lecture) ou négatif (arrivée et lecture), ou un rapport.
Énumération publiquePeekActionIndique s'il faut lire le message en cours dans une file d'attente, ou le message suivant.
Énumération publiqueQueueAccessModeSpécifie le mode d'accès de MessageQueue au moment de la création.
Énumération publiqueStandardAccessRightsSpécifie un ensemble de droits d'accès standard qui correspond aux opérations communes à la plupart des types d'objets sécurisables.
Énumération publiqueTrusteeTypeIndique le type d'un tiers de confiance.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft