WriteVals

<< Click to Display Table of Contents >>

Manual > Server Creation Guide > Interface > IPLink-Interface > IPLinkClient Library > IPLinkClient Library Reference > Method >

WriteVals

 

Writes values to multiple tags at once.

 

syntax

AxIPLink1.WriteVals(

         Count,

         TagPaths,

         Values,

         &Results

         )

 

Parameters

 

Count

 

Type:

Numeric

 

Specifies the number of tags to write.

 

TagPaths

 

Type:

String()

 

Specify the tag path as an array. (Array tags cannot be specified.)

 

Values

 

Type:

Object

 

Specify the values to be written as an Object array.

 

&Results

 

Type:

Object

 

The writing result for each tag is returned as a Boolean. It is only valid when the return value is True.

 

Return Value

 

 

Type:

Boolean

 

FALSE - Failure. TRUE - Success.

 

The WriteVals method allows you to write values to multiple tags at once.

So if you want to write to multiple tag values,WriteValThis is faster than calling the method multiple times.

Before writing a value with the WriteVals method, you must first register the tag with the AddTag method.

If the WriteVals method is called successfully, the return value will be True. Results is only valid when the return value is True, and will store the success or failure of communication for each tag.

 

 

 

Dim TagPaths(2) As String
Dim Values(2) As Object
Dim Results As Object
TagPaths(0) = "U01.F01.T01"
TagPaths(1) = "U01.F01.T02"
Values(0) = 123
Values(1) = 456
If AxIPLink1.WriteVals(2, TagPaths, Values, Results) Then
    For i = 0 To 1
        If Results(i) Then
            txtResult(i).Text = "Success!"
        Else
            txtResult(i).Text = "Error!"
        End If
    Next i
Else
    For i = 0 To 1
        txtResult (i).Text = "Error!"
    Next i
End If

 

reference

 

AddTag

WriteVal