IUANode.ChildrenRemoteRead(childVariables, timeoutMilliseconds)
Gibt eine Liste der relevanten Variablen zurück, die dem Knoten untergeordnet sind, von dem der Aufruf erfolgt. Das optionale Argument legt den Zeitbereich für den Timeout fest.
IEnumerable<RemoteChildVariableValue> ChildrenRemoteRead(IEnumerable<RemoteChildVariable>childVariables, doubletimeoutMilliseconds);
Argumente
- childVariables(IEnumerable<RemoteChildVariable>)
- Auflistung der relevanten Variablen, die als relative Pfade innerhalb des Knotens ausgedrückt werden, auf dem die API aufgerufen wird.
- timeoutMilliseconds(double)
- Die Timeout-Zeitdauer in Millisekunden, nach deren Ablauf die API eine Ausnahme erzeugt.TIPP: Wenn keine Angabe erfolgt, ist der Standardwert des Arguments30000(30 Sekunden).
Rückgabewert
- IEnumerable<RemoteChildVariableValue>
- Auflistung der relevanten Variablen, die als Paar der KlasseRemoteChildVariableValueausgedrückt werden.
- RelativePath(string)
- Der relative Pfad zur Variablen innerhalb des Knotens.
- Value(UAValue)
- Der Wert der Variable.
Beispiel
Das folgende Beispiel zeigt eine API, die eine
reads
-Liste zurückgibt, in der die im Knoten myNode
enthaltenen relevanten Variablen enthalten sind. Die beiden relevanten Variablen wurden zur Liste myVariables
hinzugefügt: eine direkt als untergeordnetes Element des Knotens (Tag1
) und eine innerhalb eines untergeordneten Knotens (NestedStructure/Tag2
).Wenn die API einen Fehler zurückgibt oder die festgelegte Timeout-Zeit erreicht wurde, erzeugt der nachstehende Beispielcode eine aus
und einem erwarteten Fehlercode für die API bestehende Fehlermeldung.ChildrenRemoteRead fehlgeschlagen:
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()); }
Rückmeldung geben