FireDAC.Comp.Client.TFDCustomTransaction.RollbackRetaining
Delphi
procedure RollbackRetaining;
C++
void __fastcall RollbackRetaining();
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomTransaction |
説明
現在のトランザクションでデータに加えられた変更をすべてキャンセルします。現在のトランザクションは終了されません。
RollbackRetaining を呼び出すと、現在のトランザクションで INSERT/UPDATE/DELETE
コマンドなどによりデータベースに加えられた変更をすべてキャンセルすることができます。FireDAC ではネストしたトランザクションをサポートしているため、現在のトランザクションは、直近の StartTransaction 呼び出しで開始されたトランザクションになります。ほとんどの DBMS のように、ネストしたトランザクションがデータベースでサポートされていない場合、FireDAC では、ネストしたトランザクションをセーブポイントを使ってエミュレートします。
RollbackRetaining を呼び出す前に、アプリケーションで Active プロパティの状態を確認することができます。
アプリケーションで RollbackRetaining を呼び出したときに現在のトランザクションがなければ、例外が発生します。
RollbackRetaining は、Interbase/Firebird の場合にはネイティブ機能を使用します。他の DBMS の場合、このメソッドは Rollback を呼び出してから StartTransaction を呼び出すのと同じになります。