Data.DB.TDataSet.Insert
Delphi
procedure Insert;
C++
HIDESBASE void __fastcall Insert();
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | Data.DB.pas Data.DB.hpp |
Data.DB | TDataSet |
説明
Insert は，新しい空のレコードをデータセットに挿入します。
Insert メソッドを呼び出すと，次の手順でレコードを挿入します。
1. Insert メソッドは，新しい空のレコードをデータセットに挿入します。
2. アクティブレコードを新しいレコードに設定します。
Insert を呼び出した後，アプリケーションはユーザーがそのレコードの項目にデータを入力できるようにし，次に，Post を使ってデータベースまたは変更ログに登録することができます（その後，クライアントデータセットは，ApplyUpdates メソッドを呼び出して，変更ログ内の更新をデータベースに適用）。新たに挿入されたレコードは，次のいずれかの方法で登録されます。
一次インデックスの付いた Paradox テーブルの場合，レコードはインデックスに基づいたデータセット内の位置に挿入される。
一次インデックスの付いていない Paradox テーブルの場合，レコードはデータセット内の現在の位置に挿入される。
dBASE，FoxPro，および Access テーブルの場合，レコードはデータセットの最後に物理的に追加される。インデックスがアクティブになった場合，新しいレコードがインデックスに関連した位置に表示されることもあるが，レコードは実際にはテーブルの最後に格納されている。
SQL データベースの場合，挿入先の物理位置は実装によって異なる。インデックスの付いたテーブルの場合，インデックスが新しいレコードの情報で更新されます。
新しいレコードがデータベースサーバーに適用された後，その物理位置はデータベースごとに異なります。インデックスの付いたテーブルの場合，インデックスが新しいレコードの情報で更新されます。