[Reference] TDataSet.InsertRecord

Data.DB.TDataSet.InsertRecord

• Up to Parent: TDataSet

Delphi

procedure InsertRecord(const Values: array of const);

C++

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

Contents

 [hide] 

• 1 Properties
• 2 Description
  • 2.1 See Also
• 3 Code Examples

Properties

Type	Visibility	Source	Unit	Parent
procedure function	public	Data.DB.pas Data.DB.hpp	Data.DB	TDataSet

Description

Inserts a new, / populated record to the dataset / and posts it.

Call InsertRecord / to create a new, empty record in the dataset, / populate it with the field values in Values, / and post the values to the database or change log. 

In C++, / the Values_Size parameter / indicates the index / of the last value in the Values array (one less than the number of values).

A newly inserted record / is posted to the database / in one of three ways:

For indexed Paradox and dBASE tables, / the record / is inserted into the dataset / in a position based on its index.

For unindexed Paradox tables, / the record / is inserted into the dataset / at the current position.

For unindexed dBASE, FoxPro, and Access tables, / the record / is inserted into the dataset at the end.

For SQL databases, / the physical location of the insert / is implementation-specific. 

For indexed tables, / the index / is updated with / the new record information.

The newly inserted record / becomes the active record.

채워진 새 레코드를 데이터 세트에 삽입하고 게시합니다.

InsertRecord를 호출하여 데이터 세트에 새 빈 레코드를 만들고, 값들에 필드 값으로 채우고, 데이터베이스 또는 변경 로그에 값을 게시합니다.

C ++에서 Values_Size 매개 변수는 Values 배열의 마지막 값에 대한 인덱스를 나타냅니다 (값들의 개수보다 하나 작다).

새로 삽입 된 레코드는 다음 세 가지 방법 중 하나로 데이터베이스에 게시됩니다.

인덱싱 된 Paradox 및 dBASE 테이블의 경우, 레코드는 해당 인덱스 기반 위치의 데이터 세트에 삽입됩니다.

인덱싱되지 않은 Paradox 테이블의 경우, 레코드가 현재 위치의 데이터 세트에 삽입됩니다.

인덱싱되지 않은 dBASE, FoxPro 및 Access 테이블의 경우, 레코드가 끝에있는 데이터 세트에 삽입됩니다.

SQL 데이터베이스의 경우, 삽입의 물리적 위치는 구현에 따라 다릅니다.

인덱스 된 테이블의 경우 인덱스가 새 레코드 정보로 업데이트됩니다.

새로 삽입된 레코드가 활성한 레코드가 됩니다.

indicate 미국·영국 [^|ɪndɪkeɪt]

1. (사실임・존재함을) 나타내다   2. (조짐・가능성을) 나타내다   3. (특히 간접적으로) 내비치다[시사하다]

implement(implementation) 미국식 동사 [^|ɪmplɪment] 명사 [^|ɪmplɪmənt]

1. 구현 2. 시행하다   3. (흔히 옥외 활동에 쓰이는 간단한) 도구

specific 미국·영국 [spə^|sɪfɪk]

1. 구체적인, 명확한, 분명한   2. 특정한   3. 특유의, 독특한

become(becomes) 미국·영국 [bɪ^|kʌm]

1. …(해)지다, …이 되다   2. 알맞다, 적절하다   3. 어울리다, 보기 좋다

출처: http://docwiki.embarcadero.com/Libraries/XE2/en/Data.DB.TDataSet.InsertRecord