WriteRefresh

<< Click to Display Table of Contents >>

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

WriteRefresh

 

タグの値をまとめて書き込み、キャッシュをリフレッシュする（推奨・高速)。

 

構文

WriteRefresh(

         tagName,

         value

         )

 

パラメータ

 

tagName

 

型：

文字

 

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

 

value

 

型：

汎用

 

書き込む値。

 

戻り値

 

 

型：

ブール

 

FALSE - 失敗。TRUE - 成功。

 

hmtoggle_plus1 解説

タグの値を書き込み、キャッシュをリフレッシュします。

 

 

hmtoggle_plus1 例

WriteRefresh は複数のタグを文字配列として指定することができます。複数のタグの値を書き込む場合、WriteRefresh を複数回呼び出すよりも１回にまとめて呼び出したほうが高速に処理されます。

 

 

// $D0、$D1、$D2 と順番に1,2,3,4,5 が書き込まれる
this.WriteRefresh( c("$D0","$D1","$D2","$D3","$D4"), c(1,2,3,4,5));

//すべてのタグに123 が書き込まれる。
this.WriteRefresh( c("$D0","$D1","$D2","$D3","$D4"), 123);

//"$D0","$D2","$D4 に123 が書き込まれ、"$D1","$D3"に456 が書き込まれる
this.WriteRefresh( c("$D0","$D1","$D2","$D3","$D4"), c(123, 456));

 

なお、配列タグに値を書き込む場合は、WriteRefresh ではなく、WriteVal を使用して、「this.WriteVal("TAG01", c(1,2,3,4));」のように記述してください。

 

 

 

サポート対象

○

スクリプトアクション

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

○

ブラウザスクリプト

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

×

演算式構文

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

 

参照

 

AddTag

DelTag

ClearAllTag

GetVal

ReadVal

WriteVal

ReadRefresh

WriteRefresh

ReadRequest

ReadRequestRefresh

WriteRequest

WriteRequestRefresh