Data.DB.TField.NewValue
Delphi
property NewValue: Variant read GetNewValue write SetNewValue;
C++
__property System::Variant NewValue = {read=GetNewValue, write=SetNewValue};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
property | public | Data.DB.pas Data.DB.hpp |
Data.DB | TField |
説明
キャッシュされている項目コンポーネントの現在の値を表します。
NewValue プロパティは,複数の更新を適用しているときに項目の現在値を調査または変更することができます。キー違反など,現在の項目値が原因で更新の適用に問題がある場合,データセットは OnUpdateError イベントを生成します。同様に,クライアントからレコードを送るときに問題が発生した場合,プロバイダコンポーネントは OnUpdateError イベントを生成します。またプロバイダに問題を知らされた場合,クライアントデータセットは OnReconcileError イベントを生成します。イベントハンドラで,NewValue に新しい値を割り当てて問題を修正できます。
レコードの登録中にエラーが発生したときを除いて,NewValue は Value と同じです。OnUpdateError イベントハンドラ,OnUpdateRecord イベントハンドラ,または OnReconcileError イベントハンドラで NewValue を設定すると,基底のデータベーステーブルへのレコードの適用が完了するまでは,NewValue と Value とが別の値になります。
メモ: NewValue プロパティは,TClientDataSet コンポーネントを使ってデータにアクセスする場合,あるいはキャッシュした更新が利用できる場合にのみ使用可能です。
関連項目