IUANode.ChildrenRemoteWrite(childVariableValues, timeoutMilliseconds)
写入针对其调用此方法的节点的所关注子变量的变量值。可选参数用于设置超时时段。
void ChildrenRemoteWrite(IEnumerable<RemoteChildVariableValue>childVariableValues, doubletimeoutMilliseconds);
参数
- childVariableValues(IEnumerable<RemoteChildVariableValue>)
- 变量及要写入的值的列表,以RemoteVariableValue类的一对属性表示,如下所示:
- Variable(IUAVariable)
- 变量。
- Value(UAValue)
- 变量的值。
- timeoutMilliseconds(double)
- 超时时段(以毫秒为单位表示),在此之后 API 将引发异常。小贴士: 如果未指定,则参数的默认值为30000(30 秒)。
示例
以下示例所示的 API 可写入
valuesToWrite
列表中定义并且包含在 myNode
节点中的变量的值。对于 valuesToWrite
列表中的每个变量,指示的第一个参数是该变量的相对路径,第二个参数是要写入的值。如果 API 返回错误或达到设置的超时时间,以下示例中的代码将生成由
组成的错误消息以及 API 的预期错误代码。ChildrenRemoteRead failed:
var valuesToWrite = new List<RemoteChildVariableValue>() { new RemoteChildVariableValue("Tag1", 4), new RemoteChildVariableValue("Tag2", "Hello world"), new RemoteChildVariableValue("Tag3", true), new RemoteChildVariableValue("NestedStructure/Tag1", 5.9) }; var myNode = Project.Current.Get("CommDrivers/Driver1/Station1/Tags/TagStructure1"); try { myNode.ChildrenRemoteWrite(valuesToWrite); } catch (Exception ex) { Log.Error("ChildrenRemoteWrite failed: " + ex.ToString()); }
提供反馈