Compartir a través de


Propiedad Index (ADO)

Se aplica a: Access 2013, Office 2013

Indica el nombre del índice 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 haber sido declarado previamente en la tabla base subyacente al objeto Recordset. Es decir, el índice debe haber sido declarado mediante programación como un objeto Index de ADOX o al crear la tabla base.

Si no se puede establecer el índice, se producirá un error en tiempo de ejecución. No se puede establecer la propiedad Index:

  • En un controlador de eventos WillChangeRecordset o RecordsetChangeComplete.

  • Si el objeto Recordset sigue ejecutando una operación (lo que se determina mediante la propiedad Estado (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; sin embargo, el objeto Recordset no se abrirá correctamente o el índice no será útil si el proveedor subyacente no admite índices.

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

Si es posible establecer el índice y la propiedad LockType es adLockPessimistic o adLockOptimistic, se realiza una operación implícita UpdateBatch. Eso libera al grupo actual y a los afectados. Se liberan todos los filtros existentes y la posición actual de la fila se cambia por la primera fila del reordenado objeto Recordset.

La propiedad Index se usa junto con el método Seek. Si el proveedor subyacente no es compatible con la propiedad Index ni con 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 integrada Index no está relacionada con la propiedad dinámica Optimize, aunque ambas tienen que ver con los índices.