IMessageFormatter Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Serializes or deserializes objects from the body of a Message Queuing message.
public interface class IMessageFormatter : ICloneable[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.MessageFormatterConverter))]
public interface IMessageFormatter : ICloneable[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.MessageFormatterConverter))>]
type IMessageFormatter = interface
interface ICloneablePublic Interface IMessageFormatter
Implements ICloneable- Derived
- Attributes
- Implements
Remarks
When an application sends a message to the queue using an instance of the MessageQueue class, the formatter serializes the object (which can be an instance of any class) into a stream and inserts it into the message body. When reading from a queue using a MessageQueue, the formatter deserializes the message data into the Body property of a Message.
BinaryMessageFormatter and ActiveXMessageFormatter provide faster throughput than the XmlMessageFormatter. The ActiveXMessageFormatter allows interoperability with Visual Basic 6.0 Message Queuing applications. The XmlMessageFormatter is loosely coupled, which means that the server and client can version the type that is sent and received independently.
Methods
| CanRead(Message) |
When implemented in a class, determines whether the formatter can deserialize the contents of the message. |
| Clone() |
Creates a new object that is a copy of the current instance. (Inherited from ICloneable) |
| Read(Message) |
When implemented in a class, reads the contents from the given message and creates an object that contains data from the message. |
| Write(Message, Object) |
When implemented in a class, serializes an object into the body of the message. |
