RefreshFromSource 方法(TagGroup 对象)

尝试从设备执行异步读取操作,并更新组中所有标签的值属性。如果成功读取所有值则返回 True,如果无法读取一个或多个值则返回 False。
语法
Result = Group
.
RefreshFromSource
(
TagsInError
)
其中
Result
– 布尔型变量的名称,如果成功读取所有值则将该变量设置为 True,一个或多个值无法读取则将其设置为 False。
Group
- 是 TagGroup 对象的名称或对 TagGroup 对象求值的表达式。
TagsInError
– StringList 类型的参数,用以返回包含无法读取的标签的名称的字符串列表集合。如果成功读取所有标签,则 TagsInError 集合将为空。如果无法读取一个或多个值,则 TagsInError 集合将包含无法读取的标签名称。
重要提示:
  • 如果在将 TagGroup 父对象的 Tag 对象设置为“活动”后立即调用标签读取(或标签写入),则应在调用标签读取(或标签写入)之前,先调用 RefreshFromSource 方法以确保对标签进行扫描。一旦成功对标签进行了扫描,则不再需要调用 RefreshFromSource 方法。
  • 或者,对于单个标签,可以使用 GetTagData 方法并将其 RefreshFromSource 参数设置为 True。
备注
  • 每个其值被成功读取的 Tag 对象的 LastErrorNumber 属性都将被设置为 0(零)。
  • 每个其值未被数据服务器成功读取的 Tag 对象都会将其 LastErrorNumber 属性设置为数据服务器返回的错误编号。将引发 tagErrorReadValue 错误,且 LastErrorString 属性将返回描述错误的文本字符串。
  • 如果此方法因其他原因失败,则会产生 tagErrorOperationFailed 错误并在描述中包含错误代码和失败原因。
提供反馈
对本文档有问题或反馈吗? 请在这里提交您的反馈
Normal