FireDAC.Comp.Client.TFDCustomCommand.RowsAffected

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

Delphi

property RowsAffected: TFDCounter read FRowsAffected;

C++

__property int RowsAffected = {read=FRowsAffected, nodefault};

プロパティ

種類 可視性 ソース ユニット
property public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomCommand

説明

直近のクエリ実行によって操作された行の数を返します。


RowsAffected を調べると、直近のコマンド操作によって挿入、更新、削除、または取得された行の数を判断することができます。処理された行がなければ、RowsAffected = 0 になります。処理された行の数を取得できなかった場合には、RowsAffected = –1 になります。

MS SQL Server の場合、ストアド プロシージャまたはテーブル トリガで SET NOCOUNT ON を省略すると、RowsAffected が -1 になってしまうことがあります。詳細は BOL を参照してください。

 procedure TForm1.ADCommand1AfterExecute(ASender: TObject);
 begin
   if ADCommand1.RowsAffected = -1 then
     StatusBar1.SimpleText := 'Ok'
   else
     case ADCommand1.CommandKind of
     skDelete: StatusBar1.SimpleText := Format('%d rows deleted', [ADCommand1.RowsAffected]);
     skInsert: StatusBar1.SimpleText := Format('%d rows inserted', [ADCommand1.RowsAffected]);
     skUpdate: StatusBar1.SimpleText := Format('%d rows updated', [ADCommand1.RowsAffected]);
     else      StatusBar1.SimpleText := Format('%d rows affected', [ADCommand1.RowsAffected]);
     end;
 end;

関連項目