TechNet
Export (0) Print
Expand All

Message.MessageType Property

 

Gets the message type: Normal, Acknowledgment, or Report.

Namespace:   System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

[MessagingDescriptionAttribute("MsgMessageType")]
public MessageType MessageType { get; }

Property Value

Type: System.Messaging.MessageType

One of the MessageType values.

Exception Condition
InvalidOperationException

The message has not been sent. This property can only be read on messages retrieved from a queue.

-or-

The message queue is filtered to ignore the MessageType property.

Message Queuing typically sets this property when it sends the message. A Message Queuing message can be one of the following types:

  • Normal, which is either a typical message sent from an application to a queue, or a response message returned to the sending application.

  • Acknowledgement, which Message Queuing generates whenever the sending application requests one. For example, Message Queuing can generate positive or negative messages to indicate that the original message arrived or was read. Message Queuing returns the appropriate acknowledgment message to the administration queue specified by the sending application.

  • Report, which Message Queuing generates whenever a report queue is defined at the source Queue Manager. When tracing is enabled, Message Queuing sends a report message to the Message Queuing report queue each time the original message enters or leaves a Message Queuing server.

The following code example displays the value of a message's MessageType property.

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft