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