Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

ActiveXMessageFormatter Class

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

For a list of all members of this type, see ActiveXMessageFormatter Members.

System.Object
   System.Messaging.ActiveXMessageFormatter

[Visual Basic]
Public Class ActiveXMessageFormatter
   Implements IMessageFormatter, ICloneable
[C#]
public class ActiveXMessageFormatter : IMessageFormatter,
   ICloneable
[C++]
public __gc class ActiveXMessageFormatter : public
   IMessageFormatter, ICloneable
[JScript]
public class ActiveXMessageFormatter implements IMessageFormatter,
   ICloneable

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Remarks

The ActiveXMessageFormatter is compatible with messages sent using Message Queuing COM components, allowing interoperability with applications that use the MSMQ COM control.

The ActiveXMessageFormatter can serialize most primitives, as well as objects that implement the IPersistStream OLE interface. It can deserialize the same set of primitives, but requires further effort when deserializing a COM object (for example, an object created using Visual Basic 6.0) that implements IPersistStream. The object to deserialize must be in memory by first importing the object into a .NET Framework application.

When an application sends a message to the queue using an instance of the MessageQueue class, the formatter serializes the object 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.

ActiveX serialization is very compact, which makes using the ActiveXMessageFormatter and MSMQ COM control a very fast method of serialization.

Requirements

Namespace: System.Messaging

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

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

See Also

ActiveXMessageFormatter Members | System.Messaging Namespace

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.