Data.Win.ADODB.TCustomADODataSet.OnWillChangeRecord
Delphi
property OnWillChangeRecord: TWillChangeRecordEvent read FOnWillChangeRecord write FOnWillChangeRecord;
C++
__property TWillChangeRecordEvent OnWillChangeRecord = {read=FOnWillChangeRecord, write=FOnWillChangeRecord};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
event | published | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | TCustomADODataSet |
説明
レコードセットのレコードが変更される前に発生します。
OnWillChangeRecord イベントハンドラを記述すると,保留中の処理がデータセットコンポーネントのレコードセットオブジェクト内の行を変更する直前に特定のアクションを実行できます。
DataSet は,OnWillChangeRecord イベントを発生させた ADO データセットコンポーネントです。このデータセットコンポーネントはまた,問題のレコードセットを保持しています。
Reason は,イベントを発生させた変更の種類を示します。TEventReason 型にはさまざまな定数が入りますが,OnWillChangeRecord イベントの Reason の値は erAddNew,erDelete,erUpdate,erUndoUpdate,erUndoAddNew,erUndoDelete,および erFirstChange に限定されます。
RecordCount は,変更されたレコードの数です。
EventStatus 値(ADO EventStatusEnum)は,イベントを起動した処理の実行が成功したか失敗したかを示します。
メモ: : OnWillChangeRecord イベントは純粋に Recordset オブジェクトイベントで,どの VCL データ変更イベントにも依存していません。