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