Properties in .NET

A .NET application uses the methods in the PropertyContext interface to get and set the properties of objects.

The PropertyContext interface encapsulates methods that get and set properties. These methods are inherited, directly or indirectly, by the following classes:

• BytesMessage
• Connection
• ConnectionFactory
• ConnectionMetaData
• Destination
• MapMessage
• Message
• MessageConsumer
• MessageProducer
• ObjectMessage
• QueueBrowser
• Session
• StreamMessage
• TextMessage

If an application sets the value of a property, the new value replaces any previous value the property had.

For more information about XMS properties, see Properties of XMS objects.

For ease of use, XMS property names and values in XMS are predefined as public constants in a struct called XMSC. The names of these constants are in the form XMSC.constant; for example, XMSC.USERID (a property name constant) and XMSC.DELIVERY_AS_APP (a value constant).

Additionally, we can access IBM MQ constants by using the IBM.XMS.MQC struct. If the IBM.XMS namespace is already imported, we can access the values for these properties in the form MQC.constant. For example, MQC.MQRO_COA_WITH_FULL_DATA.

Furthermore, if you have a hybrid application that uses both XMS .NET and IBM MQ classes for .NET and that imports both IBM.XMS and IBM.WMQ namespaces, then we must fully qualify the MQC struct namespace to ensure that each occurrence is unique.

Some advanced functionality is not currently supported within the managed .NET environment. Refer to Managed and unmanaged operations in .NET for more details.

Parent topic: Writing XMS .NET applications