ActiveXMessageFormatter.Read(Message) ActiveXMessageFormatter.Read(Message) ActiveXMessageFormatter.Read(Message) Method

Definition

Reads the contents from the given message and creates an object that contains the deserialized message.

public:
 virtual System::Object ^ Read(System::Messaging::Message ^ message);
public object Read (System.Messaging.Message message);
abstract member Read : System.Messaging.Message -> obj
override this.Read : System.Messaging.Message -> obj

Parameters

message
Message Message Message

The Message, in MSMQ ActiveX control format, to deserialize.

Returns

The deserialized message.

Implements

Exceptions

The BodyType property of the message passed as a parameter cannot be mapped to a primitive type, nor does it represent a streamed object.

The body represents a stored object. The ActiveXMessageFormatter does not support deserialization of stored objects.

Remarks

If the body of the message represents a primitive type, the message's BodyType property must be one of the managed types in the following table.

BodyType value Managed type
VT_LPSTR Char array (deserialized using ASCII encoding)
VT_BSTR, VT_LPWSTR String (deserialized using Unicode encoding)
VT_VECTOR | VT_UI1 Byte array
VT_BOOL Boolean
VT_CLSID Guid
VT_CY Decimal
VT_DATE DateTime
VT_I1, VT_UI1 Byte
VT_I2 Int16
VT_UI2 UInt16
VT_I4 Int32
VT_UI4 UInt32
VT_I8 Int64
VT_UI8 UInt64
VT_R4 Single
VT_R8 Double
VT_NULL null
VT_STREAMED_OBJECT Object

Applies to

See also