MqttApplicationMessageRetain 属性 |
该消息是否在服务器端进行保留,详细的说明参照文档的备注
Whether the message is retained on the server. For details, refer to the remarks of the document.
命名空间:
HslCommunication.MQTT
程序集:
HslCommunication (在 HslCommunication.dll 中) 版本:12.1.2.0 (12.1.2.0)
语法 public bool Retain { get; set; }
Public Property Retain As Boolean
Get
Set
public:
property bool Retain {
bool get ();
void set (bool value);
}
member Retain : bool with get, set
属性值
类型:
Boolean备注
如果客户端发给服务端的PUBLISH报文的保留(RETAIN)标志被设置为1,服务端必须存储这个应用消息和它的服务质量等级(QoS),
以便它可以被分发给未来的主题名匹配的订阅者 [MQTT-3.3.1-5]。一个新的订阅建立时,对每个匹配的主题名
,如果存在最近保留的消息,它必须被发送给这个订阅者 [MQTT-3.3.1-6]。如果服务端收到一条保留(RETAIN)标志为1的QoS 0消息,
它必须丢弃之前为那个主题保留的任何消息。它应该将这个新的QoS 0消息当作那个主题的新保留消息,但是任何时候都可以选择丢弃它 — 如果这种情况发生了,
那个主题将没有保留消息 [MQTT-3.3.1-7]
参见