Export (0) Print
Expand All
Expand Minimize
2 out of 5 rated this helpful - Rate this topic

System.Messaging Namespace

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.

Members of the MessageQueue class include the following methods for reading and writing messages to the queue:

  • The Send method enables your application to write messages to the queue. 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. The method also supports sending messages as part of a transaction.

  • The Receive, ReceiveById, and ReceiveByCorrelationId methods provide functionality for reading messages from a queue. Like the Send method, these methods provide overloads that support transactional queue processing. These methods also provide overloads with time-out.

    Out parameters that enable processing to continue if the queue is empty. Because these methods are examples of synchronous processing, they interrupt the current thread until a message is available, unless you specify a time-out.

  • The Peek method is similar to Receive, but it does not cause a message to be removed from the queue when it is read. Because Peek does not change the queue contents, there are no overloads to support transactional processing. 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.

  • The BeginPeek, EndPeek, BeginReceive, and EndReceive methods provide ways to asynchronously read messages from the queue. They do not interrupt the current thread while waiting for a message to arrive in the queue.

The following methods of the MessageQueue class provide functionality for retrieving lists of queues by specified criteria and determining if specific queues exist:

Other methods of the MessageQueue class provide the following functionality:

  • Creating and deleting Message Queueing queues.

  • Using a message enumerator to step through the messages in a queue.

  • Using a queue enumerator for iterating through the queues on the system.

  • Setting ACL-based access rights.

  • Working with the connection cache.

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

The MessageQueue component is associated with the following three formatters, which enable you to serialize and deserialize messages sent and received from queues:

  • The XmlMessageFormatter provides loosely coupled messaging, enabling independent versioning of serialized types on the client and server.

  • The ActiveXMessageFormatter is compatible with the MSMQ COM control. It allows you to send types that can be received by the control and to receive types that were sent by the control.

  • The BinaryMessageFormatter provides a faster alternative to the XmlMessageFormatter, but without the benefit of loosely coupled messaging.

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.

 ClassDescription
Public classAccessControlEntrySpecifies access rights for a trustee (user, group, or computer) to perform application-specific implementations of common tasks.
Public classAccessControlListContains a list of access control entries, specifying access rights for one or more trustees.
Public classActiveXMessageFormatterSerializes 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.
Public classBinaryMessageFormatterSerializes 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.
Public classCursorA Cursor is used to maintain a specific location in a MessageQueue when reading the queue's messages.
Public classDefaultPropertiesToSendSpecifies the default property values that will be used when sending objects other than Message instances to a message queue.
Public classMessageProvides access to the properties needed to define a Message Queuing message.
Public classMessageEnumeratorProvides a forward-only cursor to enumerate through messages in a message queue.
Public classMessagePropertyFilterControls and selects the properties that are retrieved when peeking or receiving messages from a message queue.
Public classMessageQueueProvides access to a queue on a Message Queuing server.
Public classMessageQueueAccessControlEntrySpecifies access rights for a trustee (user, group, or computer) to perform Message Queuing tasks.
Public classMessageQueueCriteriaFilters message queues when performing a query using the MessageQueue class's GetPublicQueues method.
Public classMessageQueueEnumeratorProvides a forward-only cursor to enumerate through messages in a message queue.
Public classMessageQueueExceptionThe exception that is thrown if a Microsoft Message Queuing internal error occurs.
Public classMessageQueueInstallerAllows you to install and configure a queue that your application needs in order to run. This class is called by the installation utility, for example, InstallUtil.exe, when installing a MessageQueue.
Public classMessageQueuePermissionAllows control of code access permissions for messaging.
Public classMessageQueuePermissionAttributeAllows declarative MessageQueue permission checks.
Public classMessageQueuePermissionEntryDefines the smallest unit of a code access security permission set for messaging.
Public classMessageQueuePermissionEntryCollectionContains a strongly typed collection of MessageQueuePermissionEntry objects.
Public classMessageQueueTransactionProvides a Message Queuing internal transaction.
Public classMessagingDescriptionAttributeSpecifies a description for a property or event.
Public classPeekCompletedEventArgsProvides data for the PeekCompleted event. When your asynchronous peek operation calls an event handler, an instance of this class is passed to the handler.
Public classReceiveCompletedEventArgsProvides data for the ReceiveCompleted event. When your asynchronous receive operation calls an event handler, an instance of this class is passed to the handler.
Public classSecurityContextRepresents the security context for a message in a queue.
Public classTrusteeSpecifies a user account, group account, or logon session to which an access control entry applies.
Public classXmlMessageFormatterSerializes and deserializes objects to or from the body of a message, using the XML format based on the XSD schema definition.
 InterfaceDescription
Public interfaceIMessageFormatterSerializes or deserializes objects from the body of a Message Queuing message.
 DelegateDescription
Public delegatePeekCompletedEventHandlerRepresents the method that will handle the PeekCompleted event of a MessageQueue.
Public delegateReceiveCompletedEventHandlerRepresents the method that will handle the ReceiveCompleted event of a MessageQueue.
 EnumerationDescription
Public enumerationAccessControlEntryTypeSpecifies whether to allow, deny, or revoke access rights for a trustee.
Public enumerationAcknowledgeTypesSpecifies the types of acknowledgment message that Message Queuing returns to the sending application.
Public enumerationAcknowledgmentSpecifies the result of an attempted message delivery.
Public enumerationCryptographicProviderTypeSpecifies the cryptographic service providers available for validating digital signatures.
Public enumerationEncryptionAlgorithmSpecifies the encryption algorithm used to encrypt the message body of a private message.
Public enumerationEncryptionRequiredSpecifies the privacy level of messages received by the queue.
Public enumerationGenericAccessRightsUses 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.
Public enumerationHashAlgorithmSpecifies the hash algorithm used by Message Queuing when authenticating messages.
Public enumerationMessageLookupActionSpecifies a message to peek at or receive from a message queue.
Public enumerationMessagePrioritySpecifies 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.
Public enumerationMessageQueueAccessRightsSpecifies a set of object-specific access rights for operations specific to Message Queuing.
Public enumerationMessageQueueErrorCodeIdentifies the source of an error that occurred within the Message Queuing application and generated a MessageQueueException exception.
Public enumerationMessageQueuePermissionAccessDefines access levels used by System.Messaging permission classes.
Public enumerationMessageQueueTransactionStatusSpecifies the state of an internal Message Queuing transaction.
Public enumerationMessageQueueTransactionTypeSpecifies the type of a Message Queuing transaction.
Public enumerationMessageTypeIdentifies the type of a message. 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.
Public enumerationPeekActionIndicates whether to peek the current message in a queue, or the next message.
Public enumerationQueueAccessModeSpecifies the access mode for a MessageQueue at creation time.
Public enumerationStandardAccessRightsSpecifies a set of standard access rights that correspond to operations common to most types of securable objects.
Public enumerationTrusteeTypeSpecifies the type of a trustee.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.