Beschreibung für Tag-Objekt Schreibt einen Wert synchron oder asynchron in eine Variable. Über die Eigenschaft "LastError" kann festgestellt werden, ob der Aufruf erfolgreich war. Wird der Wert der Variablen erfolgreich gesetzt, werden die Eigenschaften des Tag-Objektes mit folgenden Werten belegt: Eigenschaft Value Name QualityCode Belegung Vom Benutzer gesetzter Wert der Variablen (unverändert) Variablenname (unverändert) Bad Out of Service TimeStamp 0 LastError 0 ErrorDescription " " Wird der Variablenwert nicht erfolgreich gesetzt, werden die Eigenschaften des Tag-Objektes mit folgenden Werten belegt: Eigenschaft Value Name QualityCode Belegung Vom Benutzer gesetzter Wert der Variablen (unverändert) Variablenname (unverändert) Bad Out of Service TimeStamp 0 LastError ErrorDescription Fehlercode der Schreiboperation Fehlerbeschreibung zu LastError Syntax Ausdruck.Write [Value],[Writemode] Ausdruck Erforderlich. Ein Ausdruck, der ein Tags-Objekt zurückgibt. Der zu schreibende Wert kann der Methode als direkt übergeben werden. Wird der nicht angegeben, wird der Wert der Eigenschaft "Value" verwendet. Mit dem
optionalen "Writemode" können Sie wählen, ob der Variablenwert synchron oder asynchron geschrieben werden soll. Wird der "Writemode" nicht verwendet, wird als Defaultwert asynchron geschrieben. Bei einem Schreibvorgang werden keine Informationen zum Zustand der Variablen geliefert. In der Eigenschaft "Value" steht der Wert, der vor oder bei der Schreiboperation gesetzt wurde, er muss also nicht dem tatsächlichen aktuellen Wert der Variable entsprechen. Wenn Sie die Informationen zu der Variable aktualisieren möchten, verwenden Sie die Read-Methode. Value (optional) Writemode (optional) Beschreibung Wert der Variablen wird angegeben. Der angegebene Wert überschreibt den Wert der Eigenschaft "Value" im Tag-Objekt. Wert der Variablen wird nicht angegeben. Die Variable erhält den aktuellen Wert aus der Eigenschaft "Value" des Tag-Objektes. 0 oder leer: Der Variablenwert wird asynchron geschrieben. 0 ist der Defaultwert. 1: Der Variablenwert wird synchron geschrieben. Beim asynchronen Schreiben wird sofort in das Variablenabbild geschrieben. Der Anwender erhält keine Rückmeldung darüber, ob der Wert auch in das AS geschrieben wurde. Beim synchronen Schreiben (direkt in das AS) wird erst geschrieben, wenn das Automatisierungsgerät bereit ist. Der Anwender erhält eine Rückmeldung, wenn das Schreiben nicht erfolgreich war. Beispiel Asynchrones Schreiben 'VBS104 objtag.value = 5 objtag.write oder
'VBS105 objtag.write 5 Synchrones Schreiben 'VBS106 objtag.value = 5 objtag.write,1 oder 'VBS107 objtag.write 5, 1 Beschreibung für TagSet-Objekt Das TagSet-Objekt bietet die Möglichkeit, mehrere Variablen mit einem Aufruf zu schreiben.
Beispiel Die Funktionsweise ist dabei weitgehend mit der eines Tag-Objektes identisch. Nachfolgend werden nur die Abweichungen beschrieben. Ausdruck Erforderlich. Ein Ausdruck, der ein Objekt vom Typ "TagSet" zurückgibt. Um unterschiedliche Werte zu schreiben muss die Eigenschaft "Value" der einzelnen Tag- Objekte gesetzt und danach Write ohne "Value" aufgerufen werden. Da die Schreibaufträge zu einem Aufruf zusammengefasst werden ergibt sich eine verbesserte Performance gegenüber den Einzelaufrufen. Beim TagSet-Objekt ist es nicht möglich mit der "Write"-Methode einen Wert mitzugeben. Die einzelnen Werte müssen über die Eigenschaft "Value" der einzelnen Tag-Objekte gesetzt werden. Das folgende Beispiel zeigt wie man Variablen in die TagSet Collection aufnimmt, die Variablenwerte setzt und danach schreibt. 'VBS173 Dim group Set group = HMIRuntime.Tags.CreateTagSet group.add "Wert1" group.add "Wert2" group("wert1").value = 3 group("wert2").value = 9 group.write Setzt man den optionalen "Writemode" auf 1, so werden Prozess-Variablen synchron (direkt in das AS) geschrieben. group.write 1
Siehe auch LastError-Eigenschaft ErrorDescription-Eigenschaft TagSet-Objekt (Auflistung) Tag-Objekt