[Reference] TDataSet.MoveBy

Data.DB.TDataSet.MoveBy

• Up to Parent: TDataSet

Delphi

function MoveBy(Distance: Integer): Integer; virtual;

C++

virtual int __fastcall MoveBy(int Distance);

Contents

 [hide] 

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

Properties

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

Description

Moves to another record / relative to the active record / in the dataset.

Call MoveBy / to move the active record / by the number of records / specified by Distance. 

A positive value for Distance / indicates forward progress through the dataset, / while a negative value / indicates backward progress. 

For example, / the following statement / moves backward through / the dataset by 10 records:

데이터 세트의 활성 레코드를 기준으로 다른 레코드로 이동합니다.

MoveBy 메소드를 호출하면 Distance 의해 지정된 레코드 수만큼 활성 레코드를 이동할 수 있습니다. 

Distance가 양수이면 데이터 세트를 계속 진행하는 것을 나타냅니다. 음수면 이전으로 진행되는 것을 나타냅니다. 

예를 들어, 다음 문장에서는 데이터 세트에서 10 개의 레코드만큼 뒤로 이동합니다.

MoveBy(-10);

DataSet1->MoveBy(-10);

MoveBy / posts any changes / to the active record / and Sets the Bof and Eof properties to false.

If Distance is positive, / repeatedly fetches / Distance subsequent records (if possible), / and makes the last record fetched active. 

If an attempt / is made to move past the end of the file, / MoveBy sets Eof to true.

If Distance is negative, / repeatedly fetches / the appropriate number of previous records (if possible), / and makes the last record fetched active. 

If an attempt / is made to move past the start of the file, / MoveBy sets Bof to true. 

If the dataset is unidirectional, / the dataset raises an EDatabaseError exception / when MoveBy tries to fetch a prior record.

Broadcasts information / about the record change / so that data-aware controls / and linked datasets can update.

Returns the number of records moved. 

In most cases, / Result is the absolute value of Distance, / but if MoveBy encounters the beginning-of-file or end-of-file / before moving Distance records, / Result will be less than the absolute value of Distance.

MoveBy 는 활성 레코드에 대한 변경 사항을 게시하고 Bof 속성과 Eof 속성을 false로 설정합니다.

Distance가 양수의 경우 Distance 이후의 레코드를 반복적으로 가져오고(가능한 경우) 마지막 레코드를 가져와 활성화합니다. 

파일의 마지막을 지나 이동하려고하면 MoveBy 는 Eof 를 true로 설정합니다.

Distance가 음수이면 이전 레코드의 적절한 개수의 레코드를 반복적으로 가져오고(가능한 경우) 마지막 레코드를 가져와 활성화합니다.  

파일의 시작을 지나 이동하려고하면 MoveBy 는 Bof 을 true로 설정합니다. 

데이터 세트가 단방향의 경우 MoveBy 이전 레코드를 가져오려고 시도하면 데이터 세트에 EDatabaseError 예외를 일으킵니다.

데이터베이스 인식 컨트롤과 링크된 데이터 세트를 업데이트 할 수 있도록 레코드 변경에 대한 정보를 브로드 캐스트합니다.

이동된 레코드 개수를 반환합니다. 

대부분의 경우 Result는 Distance의 절대 값이지만, MoveBy 가 Distance 레코드들을 이동하기 전에 파일의 처음이나 끝에 도달 한 경우 Result는 Distance의 절대 값보다 작습니다.

relative 

미국·영국 [^|relətɪv]

1. (고려・판단이) 비교상의, 상대적인   2. (…과) 관련지은, (…에) 따라서 본   3. 비교적인, 상대적인

specified

명시된

subsequent

그 다음의, 차후의

attempt 

미국·영국 [ə^|tempt]

(특히 힘든 일에 대한) 시도

past 

미국식 [pӕst]

1. 지나간(시간상으로 과거에 해당하는)   2. (얼마 전인) 지난, 최근의   3. 이전의

appropriate 

미국식 형용사 [美ə^|proʊpriət] 동사 [美ə^|proʊprieɪt]

1. 적절한   2. (불법적으로나 무단으로) 도용하다   3. (특히 돈의 사용처를) 책정하다

encounter 

미국·영국 [ɪn^|kaʊntə(r)]

1. (특히 반갑지 않은 일에) 맞닥뜨리다   2. (새롭거나 뜻밖의 대상과) 접하다

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