IUANode.ChildrenRemoteRead(childVariables, timeoutMilliseconds)
Restituisce una lista delle variabili di interesse figlie del nodo per il quale viene effettuato il richiamo. L'argomento opzionale imposta il periodo di timeout.
IEnumerable<RemoteChildVariableValue> ChildrenRemoteRead(IEnumerable<RemoteChildVariable>childVariables, doubletimeoutMilliseconds);
Argomenti
- childVariables(IEnumerable<RemoteChildVariable>)
- L'elenco delle variabili di interesse, espresso come percorsi relativi all'interno del nodo su cui è stata richiamata l'API.
- timeoutMilliseconds(double)
- Il tempo di timeout, in millisecondi, dopo il quale l'API genera un'eccezione.MANCIA: Se non specificato, il valore predefinito dell'argomento è30000(30 secondi).
Restituisce
- IEnumerable<RemoteChildVariableValue>
- L'elenco delle variabili di interesse, espresso come coppia delle proprietà seguenti della classeRemoteChildVariableValue.
- RelativePath(string)
- Il percorso relativo alla variabile all'interno del nodo.
- Value(UAValue)
- Il valore della variabile.
Esempio
L'esempio seguente mostra un'API che restituisce un elenco di
reads
che contiene le variabili di interesse contenute nel nodo myNode
. Le due variabili d'interesse sono state aggiunte all'interno dell'elenco myVariables
: una direttamente figlia del nodo (Tag1
) e una all'interno di un nodo figlio (NestedStructure/Tag2
).Se l'API restituisce un errore o se si raggiunge il timeout impostato, il codice nell'esempio seguente genera un messaggio di errore composto da
e un codice di errore previsto per l'API.ChildrenRemoteRead non riuscito:
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()); }
Fornire un feedback