FireDAC.Comp.Client.TFDCustomCommand.RowsAffected
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;