System.Messaging Espace de noms
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.