<< Click to Display Table of Contents >>
マニュアル > コントロールリファレンス > 全コントロール共通 > 共通メソッド >
クライアントキャッシュをリフレッシュする(推奨・高速)。
構文
ReadRefresh(
tagName
[,dataSource = "servercache"]
)
パラメータ
型:
文字
タグ名。配列として複数のタグ名を指定することが可能。
dataSource
"servercache" - サーバーキャッシュから値を取得。
"device" - デバイスから値を取得。
戻り値
ブール
FALSE - 失敗。TRUE - 成功。
解説
クライアントキャッシュの状態を、指定したデータソースの値でリフレッシュします。リフレッシュ後にGetVal メソッドを呼び出すことにより、最新のタグ値を取得できます。
クライアントキャッシュのリフレッシュはPSTagUpdateRateルートプロパティで設定された周期で定期的に行われています。
ReadRefresh は、AddTag 直後に値を強制的にリフレッシュしたい時などに使用します。
例
ReadRefreshでは、複数のタグを文字配列として一括で指定することができます。複数のタグの値を読み込む場合、ReadRefresh を複数回呼び出すよりも、1回にまとめて呼び出したほうが高速に処理されます。
a = this.ReadRefresh( c("$D0","$D1","$D2","$D3","$D4"), "device");
サポート対象
○
スクリプトアクション
サーバのスクリプトVer2アクションで使用可能
ブラウザスクリプト
ブラウザのスクリプトにて使用可能
×
演算式構文
演算式構文(バインド書式など)にて使用可能
参照
AddTag
DelTag
ClearAllTag
GetVal
ReadVal
WriteVal
ReadRefresh
WriteRefresh
ReadRequest
ReadRequestRefresh
WriteRequest
WriteRequestRefresh