FireDAC.Comp.DataSet.TFDDataSet.Cancel

Delphi

procedure Cancel; override;

C++

virtual void __fastcall Cancel(void);

種類	可視性	ソース	ユニット	親
procedure function	public	FireDAC.Comp.DataSet.pas FireDAC.Comp.DataSet.hpp	FireDAC.Comp.DataSet	TFDDataSet

説明

Cancel は，アクティブレコードに対する変更がまだ登録されていない場合，その変更を取り消します。

FireDAC.Comp.DataSet.TFDDataSet.Cancel は Data.DB.TDataSet.Cancel を継承しています。以下の内容はすべて Data.DB.TDataSet.Cancel を参照しています。

Cancel は，アクティブレコードに対する変更がまだ登録されていない場合，その変更を取り消します。

Cancel メソッドを呼び出すと，アクティブレコードに属する 1 つまたは複数の項目に対して加えられた変更を取り消すことができます。変更がまだ登録されていないければ，Cancel はそのレコードを以前の状態に戻し，データセットの State プロパティを dsBrowse に設定します。

一般に Cancel は，ユーザーの要求に応答して変更を取り消したり，不正な項目値を取り消す項目検証ルーチンで変更を取り消したりするときに使用します。TDBNavigator オブジェクトには，Cancel メソッドを呼び出す Cancel ボタンがあります。

メモ： データセットが編集状態（dsEdit または dsInsert）になっていない場合，Cancel は何もしません。