Find 메서드(ADO)
레코드 집합에서 지정된 조건을 충족하는 행을 검색합니다. 필요에 따라 검색 방향, 시작 행 및 시작 행으로부터의 오프셋을 지정할 수 있습니다. 조건이 충족되면 현재 행 위치가 찾은 레코드에 설정됩니다. 그렇지 않으면 위치가 레코드 집합의 끝(또는 시작)으로 설정됩니다.
구문
Find (Criteria, SkipRows, SearchDirection, Start)
매개 변수
조건
검색에 사용할 열 이름, 비교 연산자 및 값을 지정하는 명령문을 포함하는 문자열 값입니다.
SkipRows
(선택 사항) 검색을 시작할 현재 행 또는 시작 책갈피의 행 오프셋을 지정하는 기본값이 0인 Long 값입니다. 기본적으로 검색은 현재 행에서 시작됩니다.
SearchDirection
(선택 사항) 검색을 현재 행에서 시작할지 또는 검색 방향으로 사용 가능한 다음 행에서 시작해야 하는지를 지정하는 SearchDirectionEnum 값입니다. 값이 adSearchForward인 경우 실패한 검색은 레코드 집합의 끝에서 중지됩니다. 값이 adSearchBackward인 경우 실패한 검색은 레코드 집합의 시작에서 중지됩니다.
시작
(선택 사항) 검색의 시작 위치로 작동하는 Variant 책갈피입니다.
설명
단일 열 이름만 조건에 지정할 수 있습니다. 이 메서드는 다중 열 검색을 지원하지 않습니다.
기준의 비교 연산자는 “>”(보다 큼), “<”(보다 작음), “=”(같음), “>=”(크거나 같음), “<=”(작거나 같음), “<>”(같지 않음) 또는 “같음”(패턴 일치)일 수 있습니다.
조건의 값은 문자열, 부동 소수점 숫자 또는 날짜일 수 있습니다. 문자열 값은 작은따옴표 또는 "#"(숫자 기호) 표시로 구분됩니다(예: "state = 'WA'" 또는 "state = #WA#"). 날짜 값은 "#"(숫자 기호) 표시로 구분됩니다(예: "start_date > #7/22/97#"). 이러한 값은 타임스탬프를 나타내는 시간, 분 및 초를 포함할 수 있지만 밀리초를 포함하면 안 됩니다. 그렇지 않으면 오류가 발생합니다.
비교 연산자가 "like"인 경우 문자열 값에 별표(*)가 포함되어 문자 또는 하위 문자열이 하나 이상 나타날 수 있습니다. 예를 들어 "'M*'과 같은 주"는 메인과 메사추세츠와 일치합니다. 선행 및 후행 별표로 값 내에 포함된 하위 문자열을 찾을 수도 있습니다. 예를 들어 "'*as*'와 같은 주"는 알래스카, 아칸소 및 매사추세츠와 일치합니다.
별표는 위에 표시된 대로 조건 문자열의 끝이나 조건 문자열의 시작과 끝에서만 사용할 수 있습니다. 별표를 선행 와일드카드('*str') 또는 포함된 와일드카드('s*r')로 사용할 수 없습니다. 이로 인해 오류가 발생합니다.
참고
찾기를 호출하기 전에 현재 행 위치가 설정되지 않은 경우 오류가 발생합니다. MoveFirst와 같은 행 위치를 설정하는 메서드는 Find를 호출하기 전에 호출해야 합니다.
참고
레코드 집합에서 Find 메서드를 호출하고 레코드 집합의 현재 위치가 마지막 레코드 또는 EOF(파일 끝)에 있는 경우 아무 것도 찾을 수 없습니다. 현재 위치/커서를 레코드 집합의 시작 부분으로 설정하려면 MoveFirst 메서드를 호출해야 합니다.