Move 메서드(ADO)

Recordset 개체에서 현재 레코드의 위치를 이동합니다.

통사론

  
recordset.Move NumRecords, Start  

매개 변수

NumRecords
현재 레코드 위치가 이동하는 레코드 수를 지정하는 부호 있는 Long 식입니다.

시작
선택적. 책갈피로 계산되는 String 값 또는 Variant. BookmarkEnum 값을 사용할 수도 있습니다.

발언

Move 메서드는 모든 Recordset 개체에서 지원됩니다.

NumRecords 인수가 0보다 크면 현재 레코드 위치가 앞으로 이동합니다(Recordset끝쪽으로). NumRecords 0보다 작으면 현재 레코드 위치가 뒤로 이동합니다(Recordset시작 부분으로 이동).

Move 호출이 현재 레코드 위치를 첫 번째 레코드 앞의 지점으로 이동하면 ADO는 레코드 집합의 첫 번째 레코드 앞에 현재 레코드를 설정합니다(BOF true ). BOF 속성이 이미 True 오류를 생성할 때 뒤로 이동하려고 합니다.

이동 호출이 현재 레코드 위치를 마지막 레코드 이후의 지점으로 이동하면 ADO는 레코드 집합의 마지막 레코드(EOF true )의 다음 위치로 현재 레코드를 설정합니다. EOF 속성이 이미 True 오류가 발생하는 경우 앞으로 이동하려고 합니다.

빈 Recordset 개체에서 Move 메서드를 호출하면 오류가 발생합니다.

Start 인수를 전달하면 이 책갈피가 있는 레코드를 기준으로 이동됩니다. Recordset 개체가 책갈피를 지원합니다. 지정하지 않으면 이동은 현재 레코드를 기준으로 합니다.

CacheSize 속성을 사용하여 공급자의 레코드를 로컬로 캐시하는 경우 현재 레코드 위치를 캐시된 레코드 그룹 외부로 이동하는 NumRecords 인수를 전달하면 ADO에서 대상 레코드부터 시작하여 새 레코드 그룹을 검색해야 합니다. CacheSize 속성은 새로 검색된 그룹의 크기를 결정하며 대상 레코드는 검색된 첫 번째 레코드입니다.

Recordset 개체가 전달된 경우 대상은 현재 캐시된 레코드 집합 내에 있는 경우 NumRecords 인수를 전달할 수 있습니다. Move 호출에서 현재 레코드 위치를 첫 번째 캐시된 레코드 이전의 레코드로 이동하면 오류가 발생합니다. 따라서 앞으로 스크롤만 지원하는 공급자를 통해 전체 스크롤을 지원하는 레코드 캐시를 사용할 수 있습니다. 캐시된 레코드는 메모리에 로드되므로 필요한 것보다 많은 레코드를 캐싱하지 않아야 합니다. 정방향 전용 Recordset 개체가 이러한 방식으로 뒤로 이동을 지원하는 경우에도 정방향 전용 Recordset 개체에서 MovePrevious 메서드를 호출하면 오류가 발생합니다.

적용 대상

ADO(Recordset 개체)

참고 항목

이동 메서드 예제(VB)
Move 메서드 예제(VBScript)
Move 메서드 예제(VC++)
MoveFirst, MoveLast, MoveNext 및 ADO(MovePrevious 메서드)
MoveFirst, MoveLast, MoveNext 및 RDS(MovePrevious 메서드)
ADO(MoveRecord 메서드)