IUANode.ChildrenRemoteRead(timeoutMilliseconds)
Gibt die Liste aller direkten untergeordneten Variablen des Knotens zurück, von dem der Aufruf erfolgt. Das optionale Argument legt den Zeitbereich für den Timeout fest.
IEnumerable<RemoteChildVariableValue> ChildrenRemoteRead(doubletimeoutMilliseconds);
Argumente
- 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>
- Die Liste der direkten untergeordneten Variablen des Knotens, ausgedrückt als Paar der folgenden Eigenschaften der KlasseRemoteChildVariableValue:
- RelativePath(string)
- Der relative Pfad zur Variablen innerhalb des Knotens.
- Value(UAValue)
- Der Wert der Variable.
Beispiel
Das folgende Beispiel zeigt eine API, die die
reads
-Liste aller im myNode
-Knoten enthaltenen Variablen zurückgibt. Für jede Variable (item
) wird eine Meldung erzeugt, die den relativen Pfad und den Wert der Variable anzeigt.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 myNode = Project.Current.Get("CommDrivers/Driver1/Station1/Tags/TagStructure1"); try { var reads = myNode.ChildrenRemoteRead(); foreach (var item in reads) Log.Info("Tag " + item.RelativePath + " has value " + item.Value); } catch (Exception ex) { Log.Error("ChildrenRemoteRead failed: " + ex.ToString()); }
Rückmeldung geben