GetTagData 方法
读取 Tag 对象的数据,并以参数变量形式返回信息。
当可选 ReadFromSource 参数为 True 时,即使指定 Tag 对象所属的 TagGroup 对象的 Active 属性为 True,仍将从源设备中读取标签值。
当 TagGroup 处于不活动状态时,该方法将从设备同步读取标签值并忽略 ReadFromSource 参数。
语法
Tag
.GetTagData
(Value, Timestamp, Quality, SubStatus, Limit
, [ReadFromSource
])其中
Tag
– 是标签对象的名称或对标签对象求值的表达式。Value
- 是一个变量类型的参数,可返回标签的值。如果值的性质为 bad
(Quality = tagQualityBad),此参数将返回 vbEmpty。TimeStamp
- 是一个日期类型的参数,可返回数据更改的时间。Quality
- 是一个 tagQualityConstants 类型的参数,可返回标签的质量状态。SubStatus
- 是一个 tagSubStatusConstants 类型的参数,可返回标签的子状态。Limit
- 是一个 tagLimitConstants 类型的参数,可返回施加于标签值的限制(如果有)。如果服务器不支持该值,则将返回 tagLimitNotLimited 常量。这些限制不同于最大值和最小值。它们的作用是指示该值是否被限定为服务器上的某个限值。ReadFromSource
- 是一个可选的布尔型参数,用于指示是否将从源设备获取标签值。
重要提示:
- 如果在将 TagGroup 父对象的 Tag 对象设置为“活动”后立即调用标签读取(或标签写入),则应在调用标签读取(或标签写入)之前,先调用 RefreshFromSource 方法以确保对标签进行扫描。一旦成功对标签进行了扫描,则不再需要调用 RefreshFromSource 方法。
- 或者,对于单个标签,可以使用 GetTagData 方法并将其 RefreshFromSource 参数设置为 True。
备注
- 如果成功读取标签值,则系统会将指定 Tag 对象的 LastErrorNumber 属性值设置为 0(零)。
- 如果数据服务器读取标签值失败,则会出现 tagErrorReadValue 错误并将 LastErrorNumber 设置为数据服务器返回的错误编号。LastErrorString 属性将返回描述该错误的文本字符串。
- 如果因其他原因无法读取标签值,则将出现 tagErrorOperationFailed 错误。
- 当需要与标签相关的值、时间戳、质量、子状态或限制时,可使用此方法读取标签的值。
提供反馈