IMessageFormatter Interface


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Serializes or deserializes objects from the body of a Message Queuing message.

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

public interface IMessageFormatter : ICloneable


When implemented in a class, determines whether the formatter can deserialize the contents of the message.


Creates a new object that is a copy of the current instance.(Inherited from ICloneable.)


When implemented in a class, reads the contents from the given message and creates an object that contains data from the message.

System_CAPS_pubmethodWrite(Message, Object)

When implemented in a class, serializes an object into the body of the message.

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.

.NET Framework
Available since 1.1
Return to top