ReadVal

<< Click to Display Table of Contents >>

マニュアル > コントロールリファレンス > 全コントロール共通 > 共通メソッド >

ReadVal

 

タグの値を取得する。

 

構文

ReadVal(

         tagName,

         value

         [,dataSource = "clientcache"]

         )

 

パラメータ

 

tagName

 

型：

文字

 

タグ名。配列として複数のタグ名を指定することが可能。

 

value

 

型：

汎用

 

読み込んだ値を格納するための数。返値がTRUE の時のみ効です。

 

dataSource

 

型：

文字

 

"clientcache" - クライアントキャッシュから値を取得。

"servercache" - サーバーキャッシュから値を取得。

"device" - デバイスから値を取得。

 

 

戻り値

 

 

型：

ブール

 

FALSE - 失敗。TRUE - 成功。

 

タグの値を取得します。GetVal とほぼ同じですが、以下の点が異なります。

 

1) dataSource が指定できる（GetVal はクライアントキャッシュ固定）。

2) 通信が成功したか失敗したかの返値が受け取れる（特に外部タグで）。

 

ReadVal は１点ずつ通信を行います。

例えばデータソース"device"の場合、ReadVal を複数回呼び出すと、そのたびにPLC との通信が行われ、全体のパフォーマンスが低下します。

そのような場合は、ReadRefresh メソッドを推奨します。

 

 

hmtoggle_plus1 例

 


 

event OnInitialize()
{
 this.AddTag("$D0");
}

event OnMouseUp(button)
{
 var a;
 if (!this.ReadVal ("$D0", a))
 {
 // エラー処理
 }
}

 

 

サポート対象

○

スクリプトアクション

サーバのスクリプトVer2アクションで使用可能

○

ブラウザスクリプト

ブラウザのスクリプトにて使用可能

×

演算式構文

演算式構文（バインド書式など）にて使用可能

 

参照

 

AddTag

DelTag

ClearAllTag

GetVal

ReadVal

WriteVal

ReadRefresh

WriteRefresh

ReadRequest

ReadRequestRefresh

WriteRequest

WriteRequestRefresh