WriteVals

<< Click to Display Table of Contents >>

マニュアル > サーバ作成ガイド > インターフェース編 > IPLinkインターフェース > IPLinkクライアントライブラリ > IPLinkクライアントライブラリ リファレンス > メソッド >

WriteVals

 

複数のタグに値を一括で書き込みます。

 

構文

AxIPLink1.WriteVals(

         Count,

         TagPaths,

         Values,

         &Results

         )

 

パラメータ

 

Count

 

型：

Numeric

 

書き込みを行うタグの個数を指定します。

 

TagPaths

 

型：

String()

 

タグパスを配列で指定します。（配列タグは指定できません。）

 

Values

 

型：

Object

 

書き込む値をObject型配列で指定します。

 

&Results

 

型：

Object

 

タグごとの書き込み結果がBooleanで返ってきます。戻り値がTrueの時のみ有効です。

 

戻り値

 

 

型：

Boolean

 

FALSE - 失敗。TRUE - 成功。

 

WriteValsメソッドは複数のタグに対して一度に値を書き込むことができます。

従って、複数のタグ値に書き込みを行いたい場合、WriteValメソッドを複数回呼び出すよりも、高速に処理が行われます。

WriteValsメソッドで値を書き込む前に、あらかじめAddTagメソッドでタグを登録しておく必要があります。

WriteValsメソッドの呼び出しに成功すると、戻り値にTrueが返ります。Resultsは戻り値がTrueの時のみ有効で、タグ毎の通信の成否が格納されます。

 

 

 

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

 

参照

 

AddTag

WriteVal