IModel.NotifyFieldChanged メソッド
名前空間: NextDesign.Core
説明
指定されたフィールドの値変更を通知します。
引数
名前 | 型 | 説明 |
---|---|---|
fieldName | string | フィールド名 |
戻り値
- void
例外
名前 | 例外クラス | 説明 |
---|---|---|
引数不正 | ExtensionArgumentException | fieldName に null、または空文字列 を指定した場合 |
フィールドが見つからない | ExtensionFieldNotFoundException | このモデルで指定されたフィールドが見つからない場合 |
注釈
このメソッドは、コールバック関数が登録されたフィールドの変更をNext DesignのUI層に通知するために利用することができます。
コールバック関数により計算された値を取得するフィールドでは、そのフィールド値が更新されたことを検出することができません。
例えば、コールバック関数により、子要素のフィールド値を取得するようなフィールドを定義した場合、そのフィールドは、子要素のフィールド値が変更されたことを認識することができません。
これは、計算元のフィールド値の変更にUI層が自動では追従しないことを意味します。
そのため、計算元のフィールド値の変更に対して、その影響を受けるコールバック関数が登録されたフィールドに対して更新通知を発行する手段を提供しています。
計算元のフィールド値が変更された場合、その影響を受けるコールバック関数が登録されたフィールドに対して更新通知を発行するのはエクステンション側の責務となります。