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인 경우 뒤로 이동하려고 하면 오류가 발생합니다.
Move 호출이 현재 레코드 위치를 마지막 레코드 뒤의 지점으로 이동하는 경우 ADO는 현재 레코드를 레코드 집합의 마지막 레코드 뒤 위치로 설정합니다(EOF는 True임). EOF 속성이 이미 True인 경우 앞으로 이동하려고 하면 오류가 발생합니다.
빈 Recordset 개체에서 Move 메서드를 호출하면 오류가 발생합니다.
Start 인수를 전달하면 Recordset 개체가 책갈피를 지원한다고 가정하면 이동은 이 책갈피가 있는 레코드를 기준으로 합니다. 지정하지 않으면 이동은 현재 레코드를 기준으로 합니다.
CacheSize 속성을 사용하여 공급자의 레코드를 로컬로 캐시하는 경우 현재 레코드 위치를 캐시된 레코드 그룹 외부로 이동하는 NumRecords 인수를 전달하면 ADO에서 대상 레코드부터 시작하여 새 레코드 그룹을 검색해야 합니다. CacheSize 속성은 새로 검색된 그룹의 크기를 결정하며 대상 레코드는 검색된 첫 번째 레코드입니다.
Recordset 개체가 전달된 경우에만 대상이 캐시된 레코드의 현재 집합 내에 있는 경우 사용자는 여전히 NumRecords 인수를 0보다 작게 전달할 수 있습니다. Move 호출에서 현재 레코드 위치를 첫 번째 캐시된 레코드 이전의 레코드로 이동하면 오류가 발생합니다. 따라서 앞으로 스크롤만 지원하는 공급자를 통해 전체 스크롤을 지원하는 레코드 캐시를 사용할 수 있습니다. 캐시된 레코드는 메모리에 로드되므로 필요한 것보다 더 많은 레코드를 캐싱하지 않아야 합니다. 정방향 전용 Recordset 개체가 이러한 방식으로 뒤로 이동을 지원하더라도 모든 정방향 전용 Recordset 개체에서 MovePrevious 메서드를 호출하면 여전히 오류가 발생합니다.
참고
공급자에 따라 정방향 전용 Recordset에서 뒤로 이동에 대한 지원은 예측할 수 없습니다. 현재 레코드가 Recordset의 마지막 레코드 다음으로 배치된 경우 뒤로 이동해도 올바른 현재 위치가 되지 않을 수 있습니다.
적용 대상
참고 항목
Move 메서드 예제(VB)
Move 메서드 예제(VBScript)
Move 메서드 예제(VC++)
MoveFirst, MoveLast, MoveNext 및 MovePrevious 메서드(ADO)
MoveFirst, MoveLast, MoveNext 및 MovePrevious 메서드(RDS)
MoveRecord 메서드(ADO)