# ReadVal

マニュアル > コントロールリファレンス > 全コントロール共通 > 共通メソッド > # 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 メソッドを推奨します。
例
    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