ObjectMessage


Class

Declaration

class ObjectMessage : Message 

Purpose

A message containing a serializable object.

Remarks

Setting the content of a MessageObject stores a snapshot of the object. subsequent changes to the original object do not affect the message.

 

Member
Description
Properties
TheObject
Object {get; set;}
Programs can get and set the object in an ObjectMessage.

 

Method
Description
Page
Constructor.
51

.NET
Compact Framework

Object serialization differs among the various EMS language APIs in ways that are incompatible. An ObjectMessage contains a serialized object. Therefore EMS programs can only send an ObjectMessage to another program written in the same language; for example, Java to Java, C to C, .NET to .NET, and .NET Compact Framework to .NET Compact Framework. In particular, notice that a .NET Compact Framework client and a full .NET client cannot exchange an ObjectMessage.

Furthermore, the .NET Compact Framework supports only a limited set of objects for TheObject in an ObjectMessage—namely, bool, int, long, short, double, float, byte, bytes, char, string, short[], int[], long[], float[], double[], MapMessage, StreamMessage, and program-defined classes that implement IEMSSerialziable. Attempting to set the value to an unsupported object type results in MessageFormatException. This restriction applies only to .NET Compact Framework (the full .NET EMS API is exempt).

Superclasses

Message

IEMSSerialziable

MessageFormatException


TIBCO Enterprise Message Service™ .NET Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com