表示: Delphi C++
表示設定

Data.DB.TDataSet.InsertRecord

提供: RAD Studio API Documentation
移動先: 案内, 検索

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 データベースの場合、挿入の物理的な位置は、実装固有です。 インデックス付きテーブルの場合、インデックスは新しいレコード情報で更新されます。

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

関連項目


コード サンプル

個人用ツール
他言語版
以前のバージョン
Assistance