Share via


Propiedad CursorType (ADO)

Especifica el tipo de cursor usado en un objeto Recordset.

Configuración y valores devueltos

Establece o devuelve un valor CursorTypeEnum. El valor predeterminado es adOpenForwardOnly.

Comentarios

Utilice la propiedad CursorType para especificar el tipo de cursor que se debe usar al abrir el objeto Recordset.

Solo se admite un valor de adOpenStatic si la propiedad CursorLocation está establecida en adUseClient. Si se establece un valor no admitido, no se producirá ningún error; en su lugar, se usará la propiedad CursorType compatible más cercana.

Si un proveedor no admite el tipo de cursor solicitado, puede devolver otro tipo de cursor. La propiedad CursorType cambiará para que coincida con el tipo de cursor real en uso cuando el objeto Recordset está abierto. Para comprobar la funcionalidad específica del cursor devuelto, use el método Supports. Después de cerrar el objeto Recordset, la propiedad CursorType vuelve a su valor original.

En el gráfico siguiente se muestra la funcionalidad del proveedor (identificada por las constantes del método Supports) necesaria para cada tipo de cursor.

Para un objeto Recordset de esta propiedad CursorType El método Supports debe devolver True para todas estas constantes.
adOpenForwardOnly ninguno
adOpenKeyset adBookmark, adHoldRecords, adMovePrevious, adResync
adOpenDynamic adMovePrevious
adOpenStatic adBookmark, adHoldRecords, adMovePrevious, adResync

Nota

Aunque Supports(adUpdateBatch) puede ser true para cursores dinámicos y de sólo avance, para las actualizaciones por lotes debe usar un conjunto de claves o un cursor estático. Establezca la propiedad LockType en adLockBatchOptimistic y la propiedad CursorLocation en adUseClient para habilitar el servicio de cursores para OLE DB, que es necesario para las actualizaciones por lotes.

La propiedad CursorType es de lectura y escritura cuando el objeto Recordset está cerrado y de solo lectura cuando está abierto.

Nota

Uso del servicio de datos remotos Cuando se usa en un objeto Recordset del lado cliente, la propiedad CursorType solo se puede establecer en adOpenStatic.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

Ejemplo de propiedades CursorType, LockType y EditMode (VB)
Ejemplo de propiedades CursorType, LockType y EditMode (VC++)
Método Supports