WritePendingValues 方法

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