FireDAC.Comp.Client.TFDCustomConnection.Commit

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

Delphi

procedure Commit;

C++

void __fastcall Commit(void);

プロパティ

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

説明

現在のトランザクションでデータに加えられた変更を永続的に保存し、場合によっては現在のトランザクションを終了します。


Commit を呼び出すと、現在のトランザクションで INSERT/UPDATE/DELETE コマンドなどによりデータベースに加えられた変更を永続的に保存できます。

FireDAC ではネストしたトランザクションをサポートしているため、現在のトランザクションは、直近の StartTransaction 呼び出しで開始されたトランザクションになります。ほとんどの DBMS のように、ネストしたトランザクションがデータベースでサポートされていない場合、FireDAC では、ネストしたトランザクションをセーブポイントを使ってエミュレートします。

Commit を呼び出す前に、アプリケーションでは InTransaction プロパティの状態を確認することもできます。アプリケーションで Commit を呼び出しても、現在のトランザクションがない場合は、例外が発生します。

InterBase または Firebird データベースに対して Commit を呼び出すと、このトランザクション オブジェクトに関連付けられているデータセットとコマンドがすべて閉じられ準備解除されます。その他の一部の DBMS(たとえば、MS SQL Server 2005 など)では、この呼び出しでアクティブな結果セットがすべて無効になります。FetchAll を強制的にアクティブなデータセットにするには、ReleaseClients メソッドを使用します。

Transaction プロパティが割り当てられている場合、Commit 呼び出しは、Transaction.Commit のショートカットです。そうでない場合は、Commit はデフォルトの接続トランザクションで操作します。

 procedure TForm1.DoThatButtonClick(Sender: TObject);
 begin
   FDConnection1.StartTransaction;
   try
     if CustomerQuery.Locate('ID', [100]) then begin
       CustomerQuery.Edit;
       CustomerQuery.FieldByName('status').AsString := 'top';
       CustomerQuery.Post;
       FDConnection1.ExecSQL('delete from debt where CustID = 100');
       FDConnection1.Commit;
     end;
   except
     FDConnection1.Rollback;
     raise;
   end;
 end;

関連項目