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

set objRecordset=Server.CreateObject("ADODB.recordset")

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")
Otras extensiones