MQPropertyDescriptor.NET 类

将 MQPropertyDescriptor 用作 MQMessage GetProperty 和 SetProperty 方法的参数。 MQPropertyDescriptor 描述了 MQMessage 属性。

类

System.Object
        |
        └─ IBM.WMQ.MQPropertyDescriptor

public class IBM.WMQ.MQPropertyDescriptor extends System.Object;

获取属性时抛出 MQException 的测试。

public int Context {get; set;}

属性所属的消息上下文。可能的值为：

MQC.MQPD_NO_CONTEXT: 该属性未与消息上下文关联。
MQC.MQPD_USER_CONTEXT: 该属性与用户上下文相关联。
如果用户已获得授权，那么检索消息时将保存与用户上下文相关联的属性。引用已保存上下文的后续 Put 方法可以将该属性传递到新消息中。

public int CopyOptions {get; set;}

CopyOptions 描述可将属性复制到的消息类型。

当队列管理器接收到包含 IBM MQ 定义的属性 (队列管理器可识别为不正确) 的消息时，队列管理器将更正 CopyOptions 字段的值。

可以指定以下选项的任意组合。通过添加值或使用按位 OR来组合选项。

MQC.MQCOPY_ALL: 此属性将复制到所有类型的后续消息中。
MQC.MQCOPY_FORWARD: 该属性将复制到要转发的消息中。
MQC.MQCOPY_PUBLISH: 在发布消息时，会将该属性复制到订户接收的消息中。
MQC.MQCOPY_REPLY: 该属性将复制到应答消息中。
MQC.MQCOPY_REPORT: 该属性将复制到报告消息中。
MQC.MQCOPY_DEFAULT: 该值指示未指定任何其他复制选项。该属性与后续消息之间不存在任何关系。始终针对消息描述符属性返回 MQC.MQCOPY_DEFAULT 。
MQC.MQCOPY_NONE: 与 MQC.MQCOPY_DEFAULT 相同

public int Options { set; }

选项缺省为 CMQC.MQPD_NONE。不能设置任何其他值。

public int Support { get; set; }

设置支持以指定 IBM MQ定义的消息属性所需的支持级别。对所有其他属性的支持是可选的。可以指定下列任何值，也可以不指定任何值

MQC.MQPD_SUPPORT_OPTIONAL

队列管理器接受该属性，即使该属性不受支持也是如此。可以废弃该属性以使消息流向不支持消息属性的队列管理器。此值还会分配给未定义 IBM MQ 的属性。

MQC.MQPD_SUPPORT_REQUIRED

需要对该属性的支持。如果将消息放入不支持 IBM MQ定义的属性的队列管理器，那么该方法将失败。它返回完成代码 MQC.MQCC_FAILED 和原因码 MQC.MQRC_UNSUPPORTED_PROPERTY。

MQC.MQPD_SUPPORT_REQUIRED_IF_LOCAL

如果消息以本地队列为目标，那么需要对该属性的支持。如果将消息放入不支持 IBM MQ定义的属性的队列管理器上的本地队列，那么该方法将失败。它返回完成代码 MQC.MQCC_FAILED 和原因码 MQC.MQRC_UNSUPPORTED_PROPERTY。

如果将消息放入远程队列管理器，那么不会进行任何检查。