ReadVals

<< Click to Display Table of Contents >>

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

ReadVals

 

複数のタグの値を一括で読み込みます。

 

構文

AxIPLink1.ReadVals(

         Count,

         TagPaths,

         &Values,

         &Results,

         DataSource

         )

 

パラメータ

 

Count

 

型：

Numeric

 

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

 

TagPaths

 

型：

String()

 

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

 

&Values

 

型：

Object

 

読み込んだ値が配列で返ってきます。戻り値がTrueの時のみ有効です。

 

&Results

 

型：

Object

 

タグごとの品質がBooleanで返ってきます。戻り値がTrueの時のみ有効です。

 

DataSource

 

型：

Numeric

 

0 – クライアントキャッシュ値。1 – サーバキャッシュ値。2 – デバイス値。

 

戻り値

 

 

型：

Boolean

 

FALSE - 失敗。TRUE - 成功。

 

ReadValsは一度に複数タグの値を一括で読み込みます。

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

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

ReadValsの呼び出しに成功すると、戻り値にTrueが設定されます。この値がTrueの時のみ、Values/Resultsが有効になります。

Valuesには取得したタグ値が、Resultsにはタグごとの値の品質（通信が成功したかどうか）が格納され、Results(x)がTrueの時、Values(x)に有効な値が格納されています。

DataSourceに関する詳細はReadValメソッドを参照してください。

 

 

 

 

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

 

参照

 

AddTag

ReadVal