System.Messaging Espace de noms

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.

Classes

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 de contrôle d’accès, qui spécifie les droits d’accès pour un ou plusieurs clients approuvés.
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 du corps 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 énumérer les messages dans une file d’attente de messages.
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 MessageQueue de la classe GetPublicQueues().
MessageQueueEnumerator	Fournit un curseur avant uniquement pour énumérer les messages dans une file d’attente de messages.
MessageQueueException	Exception levée quand 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 une description pour une propriété ou 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

IMessageFormatter

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

Énumérations

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 des 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.

Délégués

PeekCompletedEventHandler	Représente la méthode qui gérera l'événement PeekCompleted d'un MessageQueue.
ReceiveCompletedEventHandler	Représente la méthode qui gérera l'événement ReceiveCompleted d'un MessageQueue.

Remarques

Les membres de la MessageQueue classe incluent les méthodes suivantes pour lire et écrire des messages dans la file d’attente :

• La Send méthode permet à votre application d’écrire des messages dans la file d’attente. Les surcharges de la méthode vous permettent de spécifier s’il faut envoyer votre message à l’aide d’un (qui fournit un Message contrôle détaillé sur les informations que vous envoyez) ou de tout autre objet managé, y compris des classes spécifiques à l’application. La méthode prend également en charge l’envoi de messages dans le cadre d’une transaction.

• Les Receiveméthodes , ReceiveByIdet ReceiveByCorrelationId fournissent des fonctionnalités de lecture des messages à partir d’une file d’attente. Comme la méthode, ces méthodes fournissent des surcharges qui prennent en charge le Send traitement de la file d’attente transactionnelle. Ces méthodes fournissent également des surcharges avec un délai d’attente.

  Out paramètres qui permettent au traitement de continuer si la file d’attente est vide. Étant donné que ces méthodes sont des exemples de traitement synchrone, elles interrompent le thread actif jusqu’à ce qu’un message soit disponible, sauf si vous spécifiez un délai d’attente.

• La Peek méthode est similaire à Receive, mais elle n’entraîne pas la suppression d’un message de la file d’attente lorsqu’il est lu. Étant donné que Peek ne modifie pas le contenu de la file d’attente, il n’existe aucune surcharge pour prendre en charge le traitement transactionnel. Toutefois, comme Peek, Receivelit 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’empêcher le thread d’attendre indéfiniment.

• Les BeginPeekméthodes , EndPeek(IAsyncResult), BeginReceiveet EndReceive(IAsyncResult) fournissent des moyens de lire de manière asynchrone les messages de la file d’attente. Ils n’interrompent pas le thread actif en attendant qu’un message arrive dans la file d’attente.

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

• GetPrivateQueuesByMachine(String) active la récupération des files d’attente privées sur un ordinateur.

• GetPublicQueuesByCategory(Guid), GetPublicQueuesByLabel(String)et GetPublicQueuesByMachine(String) fournissent des moyens de récupérer des files d’attente publiques selon des critères communs. Une surcharge de GetPublicQueues fournit des détails encore plus fins pour la sélection des files d’attente en fonction d’un certain nombre de critères de recherche.

D’autres méthodes de la MessageQueue classe fournissent les fonctionnalités suivantes :

• Création et suppression de files d’attente de messages.

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

• Utilisation d’un énumérateur de file d’attente pour l’itération dans les files d’attente sur le système.

• Définition des droits d’accès basés sur ACL.

• Utilisation du cache de connexion.

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

Le MessageQueue composant est associé aux trois formateurs suivants, qui vous permettent de sérialiser et de désérialiser les messages envoyés et reçus à partir de files d’attente :

• Le XmlMessageFormatter fournit une messagerie faiblement couplée, permettant le contrôle de version indépendant des types sérialisés sur le client et le serveur.

• est ActiveXMessageFormatter compatible avec le contrôle COM MSMQ. Il vous permet d’envoyer des types qui peuvent être reçus par le contrôle et de recevoir les types qui ont été envoyés par le contrôle.

• offre BinaryMessageFormatter une alternative plus rapide au XmlMessageFormatter, mais sans l’avantage d’une messagerie faiblement couplée.

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