XmlMessageFormatter.Write(Message, Object) Method

Reference

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

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 an object into the body of the message.

public:
 virtual void Write(System::Messaging::Message ^ message, System::Object ^ obj);

public void Write (System.Messaging.Message message, object obj);

abstract member Write : System.Messaging.Message * obj -> unit
override this.Write : System.Messaging.Message * obj -> unit

Public Sub Write (message As Message, obj As Object)

Parameters

message: Message

The Message whose Body property will contain the serialized object.

obj: Object

The Object to be serialized into the message body.

Implements

Write(Message, Object)

Exceptions

ArgumentNullException

The message parameter is null.

-or-

The obj parameter is null.

Remarks

The target types need not be specified to write to the queue as they must be when reading. The TargetTypeNames or TargetTypes property is used by the formatter only when deserializing a message.

The XmlMessageFormatter makes use of the XmlSerializer class, which defines what can be serialized. Only public fields and public properties can be serialized. Structures, structures with arrays, and arrays of structures are all serializable, as long as they do not use the encoded style with the SOAP protocol.

Applies to