Partager via


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 :

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.