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.

• GetPrivateQueuesByMachine permet la récupération de files d'attente privées sur un ordinateur.

• GetPublicQueuesByCategory, GetPublicQueuesByLabel et GetPublicQueuesByMachine fournissent des méthodes permettant de récupérer des files d'attente publiques en fonction de critères courants. Une surcharge de GetPublicQueues fournit des informations encore plus détaillées pour sélectionner des files d'attente en fonction de plusieurs critères de recherche.

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.

Classes

	Classe	Description
	AccessControlEntry	Spé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.
	AccessControlList	Contient 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.
	ActiveXMessageFormatter	Sé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.
	BinaryMessageFormatter	Sé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.
	Cursor	Cursor est utilisé pour conserver un emplacement spécifique dans MessageQueue lors de la lecture des messages de la file d'attente.
	DefaultPropertiesToSend	Spé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.
	Message	Fournit l'accès aux propriétés nécessaires à la définition d'un message de Message Queuing.
	MessageEnumerator	Fournit un curseur avant uniquement pour l'énumération de messages dans une file d'attente.
	MessagePropertyFilter	Contrô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.
	MessageQueue	Permet d'accéder à une file d'attente sur un serveur Message Queuing.
	MessageQueueAccessControlEntry	Spé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.
	MessageQueueCriteria	Filtre les files d'attente de messages lors d'une requête effectuée à l'aide de la méthode GetPublicQueues de la classe MessageQueue.
	MessageQueueEnumerator	Fournit un curseur avant uniquement pour l'énumération de messages dans une file d'attente.
	MessageQueueException	Exception levée lorsqu'une erreur interne Microsoft Message Queuing se produit.
	MessageQueueInstaller	Vous 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.
	MessageQueuePermission	Permet de contrôler les autorisations d'accès du code pour la messagerie.
	MessageQueuePermissionAttribute	Permet de vérifier l'autorisation MessageQueue déclarative.
	MessageQueuePermissionEntry	Définit la plus petite unité d'une autorisation de sécurité d'accès du code définie pour la messagerie.
	MessageQueuePermissionEntryCollection	Contient une collection fortement typée d'objets MessageQueuePermissionEntry.
	MessageQueueTransaction	Fournit une transaction Message Queuing interne.
	MessagingDescriptionAttribute	Spécifie la description d'une propriété ou d'un événement.
	PeekCompletedEventArgs	Fournit 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.
	ReceiveCompletedEventArgs	Fournit 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.
	SecurityContext	Représente le contexte de sécurité d'un message dans une file d'attente.
	Trustee	Spé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.
	XmlMessageFormatter	Sé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.

Interfaces

	Interface	Description
	IMessageFormatter	Sérialise ou désérialise des objets du corps d'un message Message Queuing.

Délégués

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

Énumérations

	Énumération	Description
	AccessControlEntryType	Spécifie si les droits d'accès d'un tiers de confiance doivent être accordés, refusés ou révoqués.
	AcknowledgeTypes	Spécifie les types de message d'accusé de réception que Message Queuing retourne à l'application émettrice.
	Acknowledgment	Spécifie le résultat d'une tentative de remise de message.
	CryptographicProviderType	Spécifie les fournisseurs de services de chiffrement disponibles pour la validation de signatures numériques.
	EncryptionAlgorithm	Spécifie l'algorithme de chiffrement utilisé pour chiffrer le corps d'un message privé.
	EncryptionRequired	Spécifie le niveau de confidentialité des messages reçus par la file d'attente.
	GenericAccessRights	Utilise 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.
	HashAlgorithm	Spécifie l'algorithme de hachage utilisé par Message Queuing lors de l'authentification de messages.
	MessageLookupAction	Spécifie un message à lire ou à recevoir d'une file d'attente de messages.
	MessagePriority	Spé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.
	MessageQueueAccessRights	Spécifie un ensemble de droits d'accès spécifiques à un objet pour des opérations propres à Message Queuing.
	MessageQueueErrorCode	Identifie la source d'une erreur qui s'est produite dans l'application Message Queuing et qui a généré une exception MessageQueueException.
	MessageQueuePermissionAccess	Définit les niveaux d'accès employés par les classes d'autorisation System.Messaging.
	MessageQueueTransactionStatus	Spécifie l'état d'une transaction interne de Message Queuing.
	MessageQueueTransactionType	Spécifie le type d'une transaction Message Queuing.
	MessageType	Identifie 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.
	PeekAction	Indique s'il faut lire le message en cours dans une file d'attente, ou le message suivant.
	QueueAccessMode	Spécifie le mode d'accès de MessageQueue au moment de la création.
	StandardAccessRights	Spécifie un ensemble de droits d'accès standard qui correspond aux opérations communes à la plupart des types d'objets sécurisables.
	TrusteeType	Indique le type d'un tiers de confiance.