Data.DB.TDataSet.InsertRecord
Delphi
procedure InsertRecord(const Values: array of const);
C++
void __fastcall InsertRecord(const System::TVarRec *Values, const int Values_High);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | Data.DB.pas Data.DB.hpp |
Data.DB | TDataSet |
説明
新しい、値設定されたレコードを、データセットに挿入し、それを送信します。
InsertRecord を呼び出すと、新しい、空のレコードがデータセットに作成し、それを Values 内のフィールド値で設定し、その値をデータベースまたは変更ログに送信することができます。 C++ では、Values_Size パラメータは、Value 配列における最後の値のインデックスを示します（実際の値の数より 1 つ少なくなります）。
新たに挿入されたレコードは、次の 3 つのいずれかの方法で、データベースに送信されます。
インデックス付きのテーブル Paradox と dBASE の場合、レコードは、そのインデックスに基づいた位置でデータセットに挿入されます。
インデックスなしの Paradox テーブルの場合、レコードは現在の位置でデータセットに挿入されます。
インデックスなしの dBASE、FoxPro、Access テーブルの場合、レコードはデータセットの最後に挿入されます。
SQL データベースの場合、挿入の物理的な位置は、実装固有です。 インデックス付きテーブルの場合、インデックスは新しいレコード情報で更新されます。
新たに挿入されたレコードは、アクティブ レコードとなります。
関連項目