IUANode.ChildrenRemoteRead(childVariables, timeoutMilliseconds)
Restituisce un elenco di tutte le variabili di interesse degli elementi secondari del nodo in cui richiama. 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(doppio)
- Il periodo di timeout, espresso in millisecondi, dopo il quale l'API genera un'eccezione.MANCIA: Se non viene specificato, il valore predefinito dell'argomento è30000(30 secondi).
Restituisce
- IEnumerable<RemoteChildVariableValue>
- L'elenco di variabili di interesse, espresso come coppia delleRemoteChildVariableValueproprietà di classe seguenti:
- RelativePath(stringa)
- Il percorso relativo alla variabile all'interno del nodo.
- Value(UAValue)
- Il valore della variabile.
Esempio
Il seguente esempio mostra un'API che restituisce un
reads
elenco che contiene le variabili di interesse contenuto nel myNode
nodo. Le due variabili di interesse sono state aggiunte nell'elenco myVariables
: uno direttamente il figlio del nodo (Tag1
) e l'altro 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