IUANode.ChildrenRemoteRead(childVariables, timeoutMilliseconds)
Retorna uma lista de todas as variáveis filhas de interesse do nó no qual são invocadas. O argumento opcional define o período de tempo limite.
IEnumerable<RemoteChildVariableValue> ChildrenRemoteRead(IEnumerable<RemoteChildVariable>childVariables, doubletimeoutMilliseconds);
Argumentos
- childVariables(IEnumerable<RemoteChildVariable>)
- Lista das variáveis de interesse, expressa como caminhos relativos dentro do nó no qual a API é invocada.
- timeoutMilliseconds(double)
- O período de tempo limite, expresso em milissegundos, após o qual a API lança uma exceção.DICA: Se não especificado, o valor padrão do argumento é30000(30 segundos).
Retornos
- IEnumerable<RemoteChildVariableValue>
- Lista das variáveis de interesse, expressa como um par da classeRemoteChildVariableValue.
- RelativePath(string)
- O caminho em relação à variável dentro do nó.
- Value(UAValue)
- O valor da variável.
Exemplo
O exemplo a seguir mostra uma API que retorna uma lista
reads
que contém as variáveis de interesse contidas no nó myNode
. As duas variáveis de interesse foram adicionadas na lista myVariables
: uma diretamente no filho do nó (Tag1
) e outra dentro do nó filho (NestedStructure/Tag2
).Se a API retornar um erro ou se o tempo limite definido for atingido, o código no exemplo a seguir gera uma mensagem de erro composta por
e um código de erro esperado para a API.ChildrenRemoteRead falhou:
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()); }
Dê sua opinião