ADO RecordsetObjeto
Ejemplo
GetRows
Este ejemplo demuestra cómo usar el método GetRows.
Objeto Recordset
El objeto Recordset de ADO se utiliza para contener un conjunto de registros de una tabla de base de datos. Un objeto Recordset está compuesto por registros y columnas (campos).
En ADO, este objeto es el más importante y el más utilizado para operar con los datos de una base de datos.
ProgID
Cuando abre un Recordset por primera vez, el puntero de registro actual apuntará al primer registro y las propiedades BOF y EOF serán False. Si no hay registros, las propiedades BOF y EOF serán True.
El objeto Recordset puede admitir dos tipos de actualización:
- Actualización inmediata: una vez que se llama al método Update, todos los cambios se escriben inmediatamente en la base de datos. Actualización por lotes: el provider almacena en caché varios cambios y luego usa el método UpdateBatch para transferirlos a la base de datos.
En ADO, se definen 4 tipos diferentes de cursor (puntero):
- Cursor dinámico: le permite ver las adiciones, cambios y eliminaciones realizados por otros usuarios.
- Cursor de conjunto de claves: similar al cursor dinámico, excepto que no puede ver las adiciones realizadas por otros usuarios y le impide acceder a los registros eliminados por otros usuarios. Los cambios de datos realizados por otros usuarios siguen siendo visibles.
- Cursor estático: proporciona una copia estática del conjunto de registros, que se puede utilizar para buscar datos o generar informes. Además, las adiciones, cambios y eliminaciones realizados por otros usuarios no serán visibles. Cuando abre un objeto Recordset de cliente, este es el único tipo de cursor permitido.
- Cursor de solo avance: solo permite desplazarse hacia adelante en el Recordset. Además, las adiciones, cambios y eliminaciones realizados por otros usuarios no serán visibles.
El tipo de cursor se puede configurar mediante la propiedad CursorType o el parámetro CursorType en el método Open.
Nota:No todos los proveedores (providers) admiten todos los métodos y propiedades del objeto Recordset.
Propiedades
| Propiedad | Descripción |
|---|---|
| AbsolutePage | Establece o devuelve un valor que especifica el número de página en el objeto Recordset. |
| AbsolutePosition | Establece o devuelve un valor que especifica la posición ordinal (posición secuencial) del registro actual en el objeto Recordset. |
| ActiveCommand | Devuelve el objeto Command asociado al objeto Recordset. |
| ActiveConnection | Si la conexión está cerrada, establece o devuelve la definición de conexión; si la conexión está abierta, establece o devuelve el objeto Connection actual. |
| BOF | Devuelve true si la posición actual del registro está antes del primer registro; de lo contrario, devuelve false. |
| Bookmark | Establece o devuelve un marcador. Este marcador guarda la posición del registro actual. |
| CacheSize | Establece o devuelve el número de registros que se pueden almacenar en caché. |
| CursorLocation | Establece o devuelve la ubicación del servicio de cursor. |
| CursorType | Establece o devuelve el tipo de cursor de un objeto Recordset. |
| DataMember | Establece o devuelve el nombre del miembro de datos que se va a recuperar del objeto al que hace referencia la propiedad DataSource. |
| DataSource | Especifica un objeto que contiene los datos que se representarán como un objeto Recordset. |
| EditMode | Devuelve el estado de edición del registro actual. |
| EOF | Devuelve true si la posición del registro actual está después del último registro; de lo contrario, devuelve false. |
| Filter | Devuelve un filtro para los datos en el objeto Recordset. |
| Index | Establece o devuelve el nombre del índice actual del objeto Recordset. |
| LockType | Establece o devuelve un valor que especifica el tipo de bloqueo al editar un registro en un Recordset. |
| MarshalOptions | Establece o devuelve un valor que especifica qué registros se devuelven al servidor. |
| MaxRecords | Establece o devuelve el número máximo de registros que una consulta devuelve a un objeto Recordset. |
| PageCount | Devuelve el número de páginas de datos en un objeto Recordset. |
| PageSize | Establece o devuelve el número máximo de registros permitidos en una sola página del objeto Recordset. |
| RecordCount | Devuelve el número de registros en un objeto Recordset. |
| Sort | Establece o devuelve uno o más nombres de campo que sirven como base para la ordenación del Recordset. |
| Source | Establece un valor de cadena, o una referencia a un objeto Command, o devuelve un valor de cadena que puede indicar el origen de datos del objeto Recordset. |
| State | Devuelve un valor que describe si el objeto Recordset está abierto, cerrado, conectándose, ejecutándose o recuperando datos. |
| Status | Devuelve el estado del registro actual en relación con las actualizaciones por lotes u otras operaciones masivas. |
| StayInSync | Establece o devuelve si la referencia al registro secundario cambia cuando cambia la posición del registro principal. |
Métodos
| Método | Descripción |
|---|---|
| AddNew | Crea un nuevo registro. |
| Cancel | Cancela una ejecución. |
| CancelBatch | Cancela una actualización por lotes. |
| CancelUpdate | Cancela los cambios realizados en un registro del objeto Recordset. |
| Clone | Crea una copia de un Recordset existente. |
| Close | Cierra un Recordset. |
| CompareBookmarks | Compara dos marcadores. |
| Delete | Elimina un registro o un grupo de registros. |
| Find | Busca un registro en un Recordset que cumpla una determinada condición. |
| GetRows | Copia varios registros desde un objeto Recordset a una matriz bidimensional. |
| GetString | Devuelve el Recordset como una cadena. |
| Move | Mueve el puntero de registro en el objeto Recordset. |
| MoveFirst | Mueve el puntero de registro al primer registro. |
| MoveLast | Mueve el puntero de registro al último registro. |
| MoveNext | Mueve el puntero de registro al siguiente registro. |
| MovePrevious | Mueve el puntero de registro al registro anterior. |
| NextRecordset | Limpia el objeto Recordset actual y devuelve el siguiente Recordset mediante la ejecución de una serie de comandos. |
| Open | Abre un elemento de base de datos que proporciona acceso a los registros de una tabla, a los resultados de una consulta o a un Recordset guardado. |
| Requery | Actualiza los datos en el objeto Recordset reejecutando la consulta en la que se basa el objeto. |
| Resync | Refresca los datos del Recordset actual desde la base de datos original. |
| Save | Guarda el objeto Recordset en un archivo o en un objeto Stream. |
| Seek | Busca en el índice del Recordset para localizar rápidamente la fila que coincide con el valor especificado y la convierte en la fila actual. |
| Supports | Devuelve un valor booleano que define si el objeto Recordset admite un tipo específico de funcionalidad. |
| Update | Guarda todos los cambios realizados en un único registro del objeto Recordset. |
| UpdateBatch | Guarda todos los cambios del Recordset en la base de datos. Úselo en modo de actualización por lotes. |
Eventos
Nota: No puede usar VBScript ni JScript para manejar (solo se permiten los lenguajes Visual Basic, Visual C++ y Visual J++ para manejar eventos).
| Evento | Descripción |
|---|---|
| EndOfRecordset | Se desencadena cuando se intenta moverse más allá del final del Recordset. |
| FetchComplete | Se desencadena cuando todos los registros de una operación asincrónica han sido leídos. |
| FetchProgress | Se desencadena periódicamente durante una operación asincrónica para informar cuántos registros se han leído. |
| FieldChangeComplete | Se desencadena cuando cambia el valor de un objeto Field. |
| MoveComplete | Se desencadena cuando cambia la posición actual en el Recordset. |
| RecordChangeComplete | Se desencadena después de que se modifica un registro. |
| RecordsetChangeComplete | Se desencadena después de que se modifica el Recordset. |
| WillChangeField | Se desencadena antes de que cambie el valor del objeto Field. |
| WillChangeRecord | Se desencadena antes de que se modifique un registro. |
| WillChangeRecordset | Se desencadena antes de que se modifique el Recordset. |
| WillMove | Se desencadena antes de que cambie la posición actual en el Recordset. |
Colecciones
| Colección | Descripción |
|---|---|
| Fields | Indica el número de objetos Field en este objeto Recordset. |
| Properties | Contiene todos los objetos Property en el objeto Recordset. |
Propiedades de la colección Fields
| Propiedad | Descripción |
|---|---|
| Count |
Devuelve el número de elementos de la colección Fields. Comienza en 0. Ejemplo: countfields = rs.Fields.Count |
| Item(named_item/number) |
Devuelve un elemento especificado de la colección Fields. Ejemplo: itemfields = rs.Fields.Item(1) 或者 itemfields = rs.Fields.Item("Name") |
Propiedades de la colección Properties
| Propiedad | Descripción |
|---|---|
| Count |
Devuelve el número de elementos de la colección properties. Comienza en 0. Ejemplo: countprop = rs.Properties.Count |
| Item(named_item/number) |
Devuelve un elemento especificado de la colección properties. Ejemplo: itemprop = rs.Properties.Item(1) 或者 itemprop = rs.Properties.Item("Name") |