다음을 통해 공유


Index 속성

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

설정 및 반환 값

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

발언

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

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

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

  • 레코드 집합 여전히 작업을 실행하는 경우(State 속성에 의해 결정될 수 있습니다).

  • Filter 속성을 사용하여 Recordset 필터를 설정한 경우

Index 속성은 Recordset 닫혀 있지만 Recordset 성공적으로 열리지 않거나 기본 공급자가 인덱스를 지원하지 않는 경우 인덱스를 사용할 수 없는 경우 항상 성공적으로 설정할 수 있습니다.

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

인덱스를 설정할 수 있고 LockType 속성이 adLockPessimistic 또는 adLockOptimistic 경우 암시적 UpdateBatch 작업이 수행됩니다. 현재 및 영향을 받는 그룹을 해제합니다. 기존 필터가 해제되고 현재 행 위치가 다시 정렬된 Recordset첫 번째 행으로 변경됩니다.

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

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

적용 대상

ADO(Recordset 개체)

참고 항목

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