System.Messaging Namespace

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. The System.Messaging namespace provides classes that allow you to connect to, monitor, and administer message queues on the network and send, receive, or peek 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.Specifies access rights for a trustee (user, group, or computer) to perform application-specific implementations of common tasks.

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.Contains a list of access control entries, specifying access rights for one or more trustees.

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.Serializes or deserializes primitive data types and other objects to or from the body of a Message Queuing message, using a format that is compatible with the MSMQ ActiveX Component.

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.Serializes or deserializes an object, or an entire graph of connected objects, to or from the body of a Message Queuing message, using a binary format.

Cursor

Cursor est utilisé pour conserver un emplacement spécifique dans MessageQueue lors de la lecture des messages de la file d'attente.A Cursor is used to maintain a specific location in a MessageQueue when reading the queue's messages.

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.Specifies the default property values that will be used when sending objects other than Message instances to a message queue.

Message

Fournit l'accès aux propriétés nécessaires à la définition d'un message de Message Queuing.Provides access to the properties needed to define a Message Queuing message.

MessageEnumerator

Fournit un curseur avant uniquement pour l'énumération de messages dans une file d'attente.Provides a forward-only cursor to enumerate through messages in a message queue.

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.Controls and selects the properties that are retrieved when peeking or receiving messages from a message queue.

MessageQueue

Permet d'accéder à une file d'attente sur un serveur Message Queuing.Provides access to a queue on a Message Queuing server.

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.Specifies access rights for a trustee (user, group, or computer) to perform Message Queuing tasks.

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().Filters message queues when performing a query using the MessageQueue class's GetPublicQueues() method.

MessageQueueEnumerator

Fournit un curseur avant uniquement pour l'énumération de messages dans une file d'attente.Provides a forward-only cursor to enumerate through messages in a message queue.

MessageQueueException

Exception levée quand une erreur interne Microsoft Message Queuing se produit.The exception that is thrown if a Microsoft Message Queuing internal error occurs.

MessageQueueInstaller

Vous permet d'installer et de configurer une file d'attente nécessaire à l'exécution de votre application.Allows you to install and configure a queue that your application needs in order to run. Cette classe est appelée par l'utilitaire d'installation, par exemple InstallUtil.exe, lors de l'installation de MessageQueue.This class is called by the installation utility, for example, InstallUtil.exe, when installing a MessageQueue.

MessageQueuePermission

Permet de contrôler les autorisations d'accès du code pour la messagerie.Allows control of code access permissions for messaging.

MessageQueuePermissionAttribute

Permet de vérifier l'autorisation MessageQueue déclarative.Allows declarative MessageQueue permission checks.

MessageQueuePermissionEntry

Définit la plus petite unité d'une autorisation de sécurité d'accès du code définie pour la messagerie.Defines the smallest unit of a code access security permission set for messaging.

MessageQueuePermissionEntryCollection

Contient une collection fortement typée d’objets MessageQueuePermissionEntry.Contains a strongly typed collection of MessageQueuePermissionEntry objects.

MessageQueueTransaction

Fournit une transaction Message Queuing interne.Provides a Message Queuing internal transaction.

MessagingDescriptionAttribute

Spécifie une description pour une propriété ou un événement.Specifies a description for a property or event.

PeekCompletedEventArgs

Fournit des données pour l'événement PeekCompleted.Provides data for the PeekCompleted event. Lorsque votre opération de lecture asynchrone appelle un gestionnaire d'événements, une instance de cette classe est passée au gestionnaire.When your asynchronous peek operation calls an event handler, an instance of this class is passed to the handler.

ReceiveCompletedEventArgs

Fournit des données pour l'événement ReceiveCompleted.Provides data for the ReceiveCompleted event. Lorsque votre opération de réception asynchrone appelle un gestionnaire d'événements, une instance de cette classe est passée au gestionnaire.When your asynchronous receive operation calls an event handler, an instance of this class is passed to the handler.

SecurityContext

Représente le contexte de sécurité d'un message dans une file d'attente.Represents the security context for a message in a queue.

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.Specifies a user account, group account, or logon session to which an access control entry applies.

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.Serializes and deserializes objects to or from the body of a message, using the XML format based on the XSD schema definition.

Interfaces

IMessageFormatter

Sérialise ou désérialise des objets du corps d'un message Message Queuing.Serializes or deserializes objects from the body of a Message Queuing message.

É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.Specifies whether to allow, deny, or revoke access rights for a trustee.

AcknowledgeTypes

Spécifie les types de message d’accusé de réception que Message Queuing retourne à l’application émettrice.Specifies the types of acknowledgment message that Message Queuing returns to the sending application.

Acknowledgment

Spécifie le résultat d’une tentative de remise de message.Specifies the result of an attempted message delivery.

CryptographicProviderType

Spécifie les fournisseurs de services de chiffrement disponibles pour la validation de signatures numériques.Specifies the cryptographic service providers available for validating digital signatures.

EncryptionAlgorithm

Spécifie l'algorithme de chiffrement utilisé pour chiffrer le corps d'un message privé.Specifies the encryption algorithm used to encrypt the message body of a private message.

EncryptionRequired

Spécifie le niveau de confidentialité des messages reçus par la file d'attente.Specifies the privacy level of messages received by the queue.

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.Uses the Windows 2000 and Windows NT access format to specify a set of common access rights that Message Queuing maps to both standard and object-specific access rights for reading, writing, and executing.

HashAlgorithm

Spécifie l’algorithme de hachage utilisé par Message Queuing lors de l’authentification des messages.Specifies the hash algorithm used by Message Queuing when authenticating messages.

MessageLookupAction

Spécifie un message à lire ou à recevoir d'une file d'attente de messages.Specifies a message to peek at or receive from a message queue.

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.Specifies the priority Message Queuing applies to a message while it is en route to a queue, and when inserting the message into the destination queue.

MessageQueueAccessRights

Spécifie un ensemble de droits d'accès spécifiques à un objet pour des opérations propres à Message Queuing.Specifies a set of object-specific access rights for operations specific to 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.Identifies the source of an error that occurred within the Message Queuing application and generated a MessageQueueException exception.

MessageQueuePermissionAccess

Définit les niveaux d'accès employés par les classes d'autorisation System.Messaging.Defines access levels used by System.Messaging permission classes.

MessageQueueTransactionStatus

Spécifie l'état d'une transaction interne de Message Queuing.Specifies the state of an internal Message Queuing transaction.

MessageQueueTransactionType

Spécifie le type d'une transaction Message Queuing.Specifies the type of a Message Queuing transaction.

MessageType

Identifie le type d'un message.Identifies the type of a 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.A message can be a typical Message Queuing message, a positive (arrival and read) or negative (arrival and read) acknowledgment message, or a report message.

PeekAction

Indique s'il faut lire le message en cours dans une file d'attente, ou le message suivant.Indicates whether to peek the current message in a queue, or the next message.

QueueAccessMode

Spécifie le mode d'accès de MessageQueue au moment de la création.Specifies the access mode for a MessageQueue at creation time.

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.Specifies a set of standard access rights that correspond to operations common to most types of securable objects.

TrusteeType

Indique le type d'un tiers de confiance.Specifies the type of a trustee.

Délégués

PeekCompletedEventHandler

Représente la méthode qui gérera l'événement PeekCompleted d'un MessageQueue.Represents the method that will handle the PeekCompleted event of a MessageQueue.

ReceiveCompletedEventHandler

Représente la méthode qui gérera l'événement ReceiveCompleted d'un MessageQueue.Represents the method that will handle the ReceiveCompleted event of a MessageQueue.

Remarques

Membres de la MessageQueue classe incluent les méthodes suivantes pour lire et écrire des messages à la file d’attente :Members of the MessageQueue class include the following methods for reading and writing messages to the queue:

  • Le Send méthode permet à votre application écrire des messages dans la file d’attente.The Send method enables your application to write messages to the queue. Surcharges de la méthode permettent de spécifier s’il faut envoyer votre message à l’aide un Message (qui fournit un contrôle détaillé sur les informations communiquées) ou tout autre objet managé, y compris les classes spécifiques à l’application.Overloads of the method enable you to specify whether to send your message using a Message (which provides detailed control over the information you send) or any other managed object, including application-specific classes. La méthode prend également en charge l’envoi de messages dans le cadre d’une transaction.The method also supports sending messages as part of a transaction.

  • Le Receive, ReceiveById, et ReceiveByCorrelationId méthodes fournissent des fonctionnalités pour lire les messages à partir d’une file d’attente.The Receive, ReceiveById, and ReceiveByCorrelationId methods provide functionality for reading messages from a queue. Comme le Send (méthode), ces méthodes fournissent des surcharges qui prennent en charge de traitement de la file d’attente transactionnelle.Like the Send method, these methods provide overloads that support transactional queue processing. Ces méthodes fournissent également des surcharges avec délai d’attente.These methods also provide overloads with time-out.

    Les paramètres de sortie qui permettent le traitement de continuer si la file d’attente est vide.Out parameters that enable processing to continue if the queue is empty. Étant donné que ces méthodes sont des exemples de traitement synchrone, elles interrompent le thread actuel jusqu'à ce qu’un message soit disponible, sauf si vous spécifiez un délai d’attente.Because these methods are examples of synchronous processing, they interrupt the current thread until a message is available, unless you specify a time-out.

  • Le Peek méthode est similaire à Receive, mais elle n’entraîne pas un message à supprimer de la file d’attente lorsqu’il est lu.The Peek method is similar to Receive, but it does not cause a message to be removed from the queue when it is read. Étant donné que Peek ne modifie pas le contenu de la file d’attente, aucune surcharge pour prendre en charge de traitement transactionnel.Because Peek does not change the queue contents, there are no overloads to support transactional processing. Toutefois, étant donné que Peek, comme Receive, lit les messages de manière synchrone à partir de la file d’attente, les surcharges de la méthode ne prennent pas en charge la spécification d’un délai d’attente afin d’empêcher le thread d’attendre indéfiniment.However, because Peek, like Receive, reads messages synchronously from the queue, overloads of the method do support specifying a time-out in order to prevent the thread from waiting indefinitely.

  • Le BeginPeek, EndPeek(IAsyncResult), BeginReceive, et EndReceive(IAsyncResult) méthodes permettent de lire des messages de façon asynchrone à partir de la file d’attente.The BeginPeek, EndPeek(IAsyncResult), BeginReceive, and EndReceive(IAsyncResult) methods provide ways to asynchronously read messages from the queue. Ils n’interrompent pas le thread actuel en attendant un message arrive dans la file d’attente.They do not interrupt the current thread while waiting for a message to arrive in the queue.

Les méthodes suivantes de la MessageQueue classe fournit des fonctionnalités pour récupérer des listes de files d’attente selon les critères spécifiés et de déterminer si les files d’attente spécifiques existent :The following methods of the MessageQueue class provide functionality for retrieving lists of queues by specified criteria and determining if specific queues exist:

Autres méthodes de la MessageQueue classe fournissent les fonctionnalités suivantes :Other methods of the MessageQueue class provide the following functionality:

  • Création et la suppression de files d’attente de Message Queueing.Creating and deleting Message Queueing queues.

  • À l’aide d’un énumérateur de message pour parcourir les messages dans une file d’attente.Using a message enumerator to step through the messages in a queue.

  • À l’aide d’un énumérateur de la file d’attente pour l’itération dans les files d’attente sur le système.Using a queue enumerator for iterating through the queues on the system.

  • Définition des droits d’accès basé sur les ACL.Setting ACL-based access rights.

  • Utiliser le cache de connexion.Working with the connection cache.

Le Message classe fournit un contrôle détaillé sur les informations que vous envoyez à une file d’attente, et l’objet est utilisé lors de la réception ou de la lecture des messages à partir d’une file d’attente.The Message class provides detailed control over the information you send to a queue, and is the object used when receiving or peeking messages from a queue. Outre le corps du message, les propriétés de la Message classe incluent les paramètres d’accusé de réception, sélection d’un formateur, identification, informations d’authentification et de chiffrement, horodatages, des indications sur l’utilisation de suivi, la journalisation du serveur, et files d’attente de lettres mortes et les données de transaction.Besides the message body, the properties of the Message class include acknowledgment settings, formatter selection, identification, authentication and encryption information, timestamps, indications about using tracing, server journaling, and dead-letter queues, and transaction data.

Le MessageQueue composant est associé aux trois formateurs suivants, qui vous permettent de sérialiser et désérialiser les messages envoyés et reçus à partir de files d’attente :The MessageQueue component is associated with the following three formatters, which enable you to serialize and deserialize messages sent and received from queues:

  • Le XmlMessageFormatter fournit une messagerie faiblement couplée, l’activation du contrôle de version indépendant de types sérialisés sur le client et le serveur.The XmlMessageFormatter provides loosely coupled messaging, enabling independent versioning of serialized types on the client and server.

  • Le ActiveXMessageFormatter est compatible avec le contrôle COM MSMQ.The ActiveXMessageFormatter is compatible with the MSMQ COM control. Il vous permet de vous envoyer les types qui peuvent être reçus par le contrôle et de recevoir des types qui ont été envoyés par le contrôle.It allows you to send types that can be received by the control and to receive types that were sent by the control.

  • Le BinaryMessageFormatter offre une alternative plus rapide à la XmlMessageFormatter, mais sans l’avantage de la messagerie faiblement couplée.The BinaryMessageFormatter provides a faster alternative to the XmlMessageFormatter, but without the benefit of loosely coupled messaging.

Autres classes dans le Messaging espace de noms prennent en charge l’accès du code et la sécurité basée sur les ACL, filtrage Message propriétés lors de la lecture des messages à partir d’une file d’attente et à l’aide de transactions lors de l’envoi et la réception des messages.Other classes in the Messaging namespace support code-access and ACL-based security, filtering Message properties when reading messages from a queue, and using transactions when sending and receiving messages.