[Reference] TDataSet.Insert

Data.DB.TDataSet.Insert

• Up to Parent: TDataSet

Delphi

procedure Insert;

C++

HIDESBASE void __fastcall Insert(void);

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, / empty record in the dataset.

Call Insert to:

1. Open a new, / empty record in the dataset.
2. Set the active record / to the new record.

After a call to Insert, / an application can allow users to enter data in the fields of the record, and then post those changes to the database or change log using Post. (Client datasets can subsequently apply updates in the change log back to the database by calling ApplyUpdates.) A newly inserted record is posted in one of three ways:

• For Paradox tables with primary indexes, / the record / is inserted into the dataset / in a position based on its index.
• For Paradox tables without primary indexes, / the record is / inserted into the dataset / at the current position.
• For dBASE, FoxPro, and Access tables, / the record / is physically appended to the dataset / at the end. 
• If an index happens to be active, / the new record may appear / in a position relative to the index, / but the record / is still actually stored / at the end of the table.
• For SQL databases, / the physical location of the insert / is implementation-specific. 
• For indexed tables, / the index is updated / with the new record information.

After the new record is applied back to the database server, / its physical location is database-specific. 

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

데이터 세트에 빈 레코드를 새로 삽입합니다.

Insert 메소드 호출:

1. 데이터 세트에서 빈 레코드를 새로 오픈합니다.

2. 활성한 레코드를 새 레코드로 설정합니다.

Insert 를 호출 한 후 응용 프로그램은 사용자가 레코드 필드에 데이터를 입력 할 수 있도록 한 다음 해당 변경 사항을 데이터베이스에 게시하거나  Post 를 사용하여 로그를 변경할 수 있습니다. (클라이언트 데이터 세트는 ApplyUpdates 를 호출하여 변경 로그의 업데이트를 데이터베이스에 다시 적용할 수 있습니다). 

새로 삽입된 레코드는 다음 세가지 중 하나의 방법으로 게시됩니다.

• 기본 인덱스가있는 Paradox 테이블의 경우 레코드는 해당 인덱스를 기반으로 한 위치의 데이터 세트에 삽입된다.

• 기본 인덱스가 붙어 있지 않은 Paradox 테이블의 경우 레코드는 현재 위치의 데이터 세트에 삽입된다.

• dBASE, FoxPro 및 Access 테이블의 경우 레코드가 물리적으로 마지막에 데이터세트에 추가된다. 

• 인덱스가 활성화 되어 있으면 새 레코드가 인덱스에 관련한 위치에 나타날 수 있지만, 레코드는 여전히 실제로 테이블의 마지막에 저장됩니다.

• SQL 데이터베이스의 경우 삽입되는 실제 위치는 구현에 따라 다르다. 

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

새 레코드가 다시 데이터베이스 서버에 적용된 후 그 물리적 위치는 데이터베이스마다 다릅니다. 

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

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