Data.DB.TDataSet.InsertRecord

• 親: TDataSet

Delphi

procedure InsertRecord(const Values: array of const);

C++

void __fastcall InsertRecord(System::TVarRec const *Values, const int Values_Size);

プロパティ

種類	可視性	ソース	ユニット	親
procedure function	public	Data.DB.pas Data.DB.hpp	Data.DB	TDataSet

説明

データセットに値の入った新しいレコードを挿入し，それを変更ログに登録します。

InsertRecord メソッドを呼び出すと，データセットに新しい空のレコードを追加し，Values の項目値をそのレコードに入れ，それらの値をデータベースまたは変更ログに登録できます。C++の場合，Values_Size パラメータは，Values 配列の最後の値のインデックス（値の総数から 1 引いた値）です。

新たに挿入されたレコードは，次のいずれかの方法でデータベースに登録されます。

インデックスの付いた Paradox および dBASE テーブルの場合，レコードはインデックスに基づいたデータセット内の位置に挿入されます。

インデックスの付いていない Paradox および dBASE テーブルの場合，レコードはデータセット内の現在の位置に挿入されます。

インデックスの付いていない dBASE，FoxPro および Access テーブルの場合，レコードはデータセットの末尾に挿入されます。

SQL データベースの場合，挿入先の物理位置は実装によって異なります。インデックスの付いたテーブルの場合，インデックスが新しいレコードの情報で更新されます。

新たに挿入されたレコードがアクティブレコードになります。

関連項目

• AppendRecord

• Insert

• Post

• SetFields

• レコード全体の変更