Fügt dem gerade verarbeiteten STRING ein Paar Name/Wert hinzu. Das Format des dem STRING hinzugefügten Werts ist vom Datentyp der dem Eingang i_anyValue zugewiesenen Variablen abhängig. Der zugewiesene Wert wird nach Bedarf in einen ASCII STRING konvertiert und im geeigneten Format im gerade verarbeiteten STRING hinzugefügt.
Im Gegensatz zu den Methoden AddNameValuePair<data type>, die nur einen bestimmten Datentyp für den Wert unterstützen, bietet diese Einzelmethode Unterstützung für mehrere Datentypen für den Eingang i_anyValue.
Für den Eingang i_anyValue werden Variablen vom Datentyp BOOL, STRING, INT, UINT, DINT, UDINT, BYTE, WORD, DWORD, LWORD, REAL, LREAL, SINT, USINT, LINT, ULINT, TIME, LTIME, DATE_AND_TIME, DATE und TOD unterstützt.
Der Rückgabewert ist TRUE, wenn die Funktion erfolgreich ausgeführt wurde. Prüfen Sie die Eigenschaft Result, wenn der Wert FALSE zurückgegeben wird.
Das Scheitern der Ausführung der Methode kann auf folgende Ursachen zurückzuführen sein:
|
Mögliche Ursache |
Ergebnis |
|---|---|
|
Die maximale Länge des aktuellen STRING wurde erreicht. |
Der STRING bleibt unverändert. |
|
Der Datentyp (z. B. ARRAY oder WSTRING) der i_anyValue zugewiesenen Variablen wird nicht unterstützt. |
Der STRING bleibt unverändert. |
|
Eingang |
Datentyp |
Beschreibung |
|---|---|---|
|
i_sName |
STRING (GPL.Gc_uiJsonMaxLengthOfName) |
Gibt den Namen des hinzuzufügenden Namens-/Wertepaars an. Die Anführungszeichen um den <name> dürfen nicht explizit angegeben, sondern müssen implizit über die Methode hinzugefügt werden. |
|
i_anyValue |
ANY* |
Gibt den hinzuzufügenden Wert an. |
|
* Unterstützte Datentypen: BOOL, STRING, INT, UINT, DINT, UDINT, BYTE, WORD, DWORD, LWORD, REAL, LREAL, SINT, USINT, LINT, ULINT, TIME, LTIME, DATE_AND_TIME, DATE und TOD. |
||
Beim Aufruf der Methode AddNameValuePair wird dem STRING Text (im Beispiel in violetter Fettschrift) hinzugefügt:
{"Key":1,"<name>":<value>}
<name> entspricht dem über den Eingang i_sName der Methode angegebenen Wert.
<value> entspricht dem über den Eingang i_anyValue der Methode angegebenen Wert.
