Propiedad Index

Indica el nombre del índice actualmente en vigor para un objeto Recordset.

Configuración y valores devueltos

Establece o devuelve un valor de tipo String, que es el nombre del índice.

Comentarios

El índice denominado por la propiedad Index debe haberse declarado previamente en la tabla base subyacente al objeto Recordset. Es decir, el índice debe haberse declarado mediante programación como un objeto Index de ADOX, o cuando se creó la tabla base.

Se producirá un error en tiempo de ejecución si no se puede establecer el índice. La propiedad Index no se puede establecer en las condiciones siguientes:

• Dentro de un controlador de eventos WillChangeRecordset o RecordsetChangeComplete.

• Si el objeto Recordset sigue ejecutando una operación (que puede determinarse mediante la propiedad State).

• Si se ha establecido un filtro en el objeto Recordset con la propiedad Filter.

La propiedad Index siempre se puede establecer correctamente si el objeto Recordset está cerrado, pero el objeto Recordset no se abrirá correctamente o el índice no se podrá usar si el proveedor subyacente no admite índices.

Si se puede establecer el índice, la posición de fila actual puede cambiar. Esto provocará una actualización de la propiedad AbsolutePosition y desencadenará los eventos WillChangeRecordset, RecordsetChangeComplete, WillMove y MoveComplete.

Si se puede establecer el índice y la propiedad LockType es adLockPessimistic o adLockOptimistic, se realiza una operación UpdateBatch implícita. Esto libera los grupos actuales y afectados. Se libera cualquier filtro existente y la posición de fila actual se cambia a la primera fila del objeto Recordset reordenado.

La propiedad Index se usa junto con el método Seek. Si el proveedor subyacente no admite la propiedad Index y, por tanto, el método Seek, considere la posibilidad de usar el método Find en su lugar. Determine si el objeto Recordset admite índices con el método Supports(adIndex).

La propiedad Index integrada no está relacionada con la propiedad Optimize dinámica, aunque ambas tratan con índices.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

Ejemplo del método Seek y de la propiedad Index (VB)
Objeto Index (ADOX)
El método de búsqueda