Data.Win.ADODB.TCustomADODataSet.OnWillChangeField

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

property OnWillChangeField: TWillChangeFieldEvent read FOnWillChangeField write FOnWillChangeField;

C++

__property TWillChangeFieldEvent OnWillChangeField = {read=FOnWillChangeField, write=FOnWillChangeField};

プロパティ

種類 可視性 ソース ユニット
event published
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Data.Win.ADODB TCustomADODataSet

説明

項目が変更される前に発生します。

OnWillChangeField イベントハンドラを記述すると,保留中の処理が Recordset オブジェクト内の 1 つまたは複数の ADO Field オブジェクトの値を変更する前に特定のアクションを実行できます(ここでいう「Field オブジェクト」という用語は,TField から継承した VCL 静的項目オブジェクトではなく ADO Field オブジェクトを示します)。

DataSet は,OnWillChangeField イベントを発生させた ADO データセットコンポーネントです。このデータセットコンポーネントはまた,問題のレコードセットを保持しています。

FieldCount は,Fields パラメータ内の ADO Field オブジェクトの数です。

Fields は,処理で正に変更されようとしている ADO Field オブジェクトを表す Variants の配列です。ADO Field オブジェクトの使い方の詳細は,Microsoft Data Access SDK を参照してください。

EventStatus 値(ADO EventStatusEnum)は,イベントを起動した処理の実行が成功したか失敗したかを示します。

メモ:  : Recordset オブジェクトの Field オブジェクトは,その ADO データセットコンポーネントの VCL 項目オブジェクトとは異なります。OnWillChangeField イベントは純粋に Recordset オブジェクトイベントで,どの VCL 項目変更イベントにも依存していません。

関連項目