GetRows 메서드(ADO)
Recordset 개체의 여러 레코드를 배열로 검색합니다.
구문
array = recordset.GetRows(Rows, Start, Fields )
Return Value
값이 2차원 배열인 Variant를 반환합니다.
매개 변수
행
(선택 사항) 검색할 레코드 수를 나타내는 GetRowsOptionEnum 값입니다. 기본값은 adGetRowsRest입니다.
시작
(선택 사항) GetRows 작업을 시작해야 하는 레코드의 책갈피로 계산되는 String 값 또는 Variant입니다. BookmarkEnum 값을 사용할 수도 있습니다.
필드
(선택 사항) 단일 필드 이름 또는 서수 위치 또는 필드 이름 또는 서수 위치 번호 배열을 나타내는 Variant입니다. ADO는 이러한 필드의 데이터만 반환합니다.
설명
GetRows 메서드를 사용하여 Recordset의 레코드를 2차원 배열로 복사합니다. 첫 번째 아래 첨자는 필드를 식별하고 두 번째 첨자는 레코드 번호를 식별합니다. GetRows 메서드가 데이터를 반환하면 array 변수가 자동으로 올바른 크기로 차원화됩니다.
Rows 인수에 대한 값을 지정하지 않으면 GetRows 메서드는 Recordset 개체의 모든 레코드를 자동으로 검색합니다. 사용 가능한 것보다 많은 레코드를 요청하는 경우 GetRows는 사용 가능한 레코드 수만 반환합니다.
Recordset 개체가 책갈피를 지원하는 경우 Start 인수에서 해당 레코드의 Bookmark 속성 값을 전달하여 GetRows 메서드가 데이터 검색을 시작할 레코드를 지정할 수 있습니다.
GetRows 호출이 반환하는 필드를 제한하려면 Fields 인수에 단일 필드 이름/숫자 또는 필드 이름/숫자 배열을 전달할 수 있습니다.
GetRows를 호출한 후 읽지 않은 다음 레코드는 현재 레코드가 되거나, 레코드가 더 이상 없으면 EOF 속성이 True로 설정됩니다.