IMessageFormatter Interface

Definition

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

Applies to

See also