Share via

Index 속성

  • 아티클

Recordset 개체에 현재 적용 중인 인덱스의 이름을 나타냅니다.

설정 및 반환 값

인덱스의 이름인 String 값을 설정하거나 반환합니다.

설명

Index 속성에 의해 명명된 인덱스가 Recordset 개체의 기본 테이블에 이전에 선언되어 있어야 합니다. 즉, 인덱스는 ADOX Index 개체 또는 기본 테이블을 만들 때 프로그래밍 방식으로 선언되어야 합니다.

인덱스가 설정되지 않으면 런타임 오류가 발생합니다. Index 속성은 다음 조건에서 설정할 수 없습니다.

  • WillChangeRecordset 또는 RecordsetChangeComplete 이벤트 처리기 내에서

  • 레코드 집합이 여전히 작업을 실행 중인 경우(State 속성에 의해 결정될 수 있음)

  • Filter 속성을 사용하여 레코드 집합에 필터가 설정된 경우

레코드 집합이 닫혔지만 레코드 집합이 열리지 않거나, 인덱스를 사용할 수 없거나, 기본 공급자가 인덱스를 지원하지 않는 경우에도 항상 Index 속성을 설정할 수 있습니다.

인덱스를 설정할 수 있으면 현재 행 위치가 변경될 수 있습니다. 이렇게 하면 AbsolutePosition 속성이 업데이트되고 WillChangeRecordset, RecordsetChangeComplete, WillMove, MoveComplete 이벤트가 발생합니다.

인덱스를 설정할 수 있고 LockType 속성이 adLockPessimistic 또는 adLockOptimistic이면 암시적 UpdateBatch 작업이 수행됩니다. 이렇게 하면 현재 및 영향을 받는 그룹을 해제합니다. 모든 기존 필터가 해제되고 현재 행 위치가 순서가 변경된 레코드 집합의 첫 번째 행으로 변경됩니다.

Index 속성은 Seek 메서드와 함께 사용됩니다. 기본 공급자가 Index 속성을 지원하지 않는 경우 Seek 메서드이기 때문에 Find 메서드를 대신 사용하는 것이 좋습니다. Recordset 개체가 Supports(adIndex) 메서드를 사용하여 인덱스를 지원하는지 여부를 확인합니다.

기본 제공 Index 속성은 동적 Optimize 속성과 관련이 없지만 둘 다 인덱스를 처리합니다.

적용 대상

레코드 집합 개체(ADO)

참고 항목

SSeek 메서드 및 Index 속성 예제(VB)
인덱스 개체(ADOX)
Seek 메서드