IUANode.ChildrenRemoteRead(childVariables, timeoutMilliseconds)
Renvoie une liste de toutes les variables des enfants d'intérêt du nœud sur lequel elle est appelée. L'argument facultatif définit le délai d'expiration.
IEnumerable<RemoteChildVariableValue> ChildrenRemoteRead(IEnumerable<RemoteChildVariable>childVariables, doubletimeoutMilliseconds);
Arguments
- childVariables(IEnumerable<RemoteChildVariable>)
- Liste des variables d'intérêt, exprimée sous forme de chemins relatifs à l'intérieur du nœud sur lequel l'API est appelée.
- timeoutMillisecondsDouble
- Le délai d’expiration, exprimé en millisecondes, après lequel l’API génère une exception.CONSEIL: Si elle n’est pas spécifiée, la valeur par défaut de l’argument est30000(30 secondes).
Renvoie
- IEnumerable<RemoteChildVariableValue>
- Liste des variables d’intérêt, exprimée sous la forme d’une paire de la classeRemoteChildVariableValue.
- RelativePath(string)
- Chemin relatif vers la variable à l'intérieur du nœud.
- Value(UAValue)
- Valeur de la variable.
Exemple
L'exemple suivant présente une API qui renvoie une liste
reads
contenant les variables d'intérêt contenues dans le nœud myNode
. Les deux variables d’intérêt ont été ajoutées dans la liste myVariables
: un enfant direct du nœud (Tag1
) et l’autre à l’intérieur d’un nœud enfant (NestedStructure/Tag2
).Si l'API renvoie une erreur ou si le délai d'expiration défini est atteint, le code dans l'exemple suivant génère un message d'erreur composé de
et un code d’erreur attendu pour l’API.Échec de ChildrenRemoteRead :
var myVariables = new List<RemoteChildVariable>() { new RemoteChildVariable("Tag1"), new RemoteChildVariable("NestedStructure/Tag2") }; var myNode = Project.Current.Get("CommDrivers/Driver1/Station1/Tags/TagStructure1"); try { var reads = myNode.ChildrenRemoteRead(myVariables); } catch (Exception ex) { Log.Error("ChildrenRemoteRead failed: " + ex.ToString()); }
Fournir une réponse