Ejemplos
GetRows
Este ejemplo muestra cómo utilizar el método GetRows.
objeto de registros
El objeto ADO de registros se utiliza para mantener un conjunto de registros de una tabla de base de datos. Un objeto de registros consta de los registros y columnas (fields) .
En ADO, este objeto es la más importante y la que se utiliza más a menudo para manipular datos de una base de datos.
ProgID
set objRecordset=Server.CreateObject("ADODB.recordset")
Cuando se abre por primera vez un conjunto de registros, el puntero de registro actual se apunte al primer registro y el BOF y EOF propiedades son falsas. Si no hay registros, el BOF y la propiedad EOF son True.
objetos de conjunto de registros pueden soportar dos tipos de actualización:
- Immediate updating - todos los cambios se escriben inmediatamente en la base de datos una vez que se llama al método de actualización.
- Batch updating - el proveedor de caché múltiples cambios y luego enviarlos a la base de datos con el método UpdateBatch.
En ADO hay 4 tipos de cursor diferentes definidos:
- Dynamic cursor - Le permite ver las adiciones, cambios y eliminaciones por otros usuarios.
- Keyset cursor - Al igual que un cursor dinámico, excepto que no se puede ver adiciones por otros usuarios y que impide el acceso a los registros que otros usuarios han suprimido. cambios en los datos de otros usuarios seguirán siendo visibles.
- Static cursor - Proporciona una copia estática de un conjunto de registros que puede utilizar para buscar datos o generar informes. Las adiciones, modificaciones o supresiones de otros usuarios no serán visibles. Este es el único tipo de cursor permitido cuando se abre un objeto de registros de cliente.
- Forward-only cursor - Permite sólo para desplazarse hacia adelante a través del conjunto de registros. Las adiciones, modificaciones o supresiones de otros usuarios no serán visibles.
El tipo de cursor se puede ajustar por la propiedad CursorType o por el parámetro CursorType en el método Open.
Note: No todos los proveedores soportan todos los métodos o 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 de conjunto de registros |
| AbsolutePosition | Establece o devuelve un valor que especifica la posición ordinal del registro actual en el objeto de conjunto de registros |
| ActiveCommand | Devuelve el objeto de comando asociado con el conjunto de registros |
| ActiveConnection | Establece o devuelve una definición para una conexión si la conexión se cierra, o el objeto de conexión actual si la conexión está abierta |
| BOF | Devuelve verdadero si la posición del registro actual es antes del primer registro, de lo contrario falso |
| Bookmark | Establece o devuelve un marcador. El 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 de conjunto de registros |
| DataMember | Establece o devuelve el nombre del miembro de datos que se va a recibir desde el objeto al que hace referencia la propiedad DataSource |
| DataSource | Especifica un objeto que contiene datos que se representa como un objeto de conjunto de registros |
| EditMode | Devuelve el estado de edición del registro actual |
| EOF | Devuelve verdadero si la posición del registro actual es posterior al último registro, de lo contrario falso |
| Filter | Establece o devuelve un filtro para los datos en un objeto de conjunto de registros |
| Index | Establece o devuelve el nombre del índice actual de un objeto de conjunto de registros |
| LockType | Establece o devuelve un valor que especifica el tipo de bloqueo al editar un registro en un conjunto de registros |
| MarshalOptions | Establece o devuelve un valor que especifica qué registros deben ser devueltos al servidor |
| MaxRecords | Establece o devuelve el número máximo de registros para volver a un objeto de conjunto de registros de una consulta |
| PageCount | Devuelve el número de páginas con datos en un objeto de registros |
| PageSize | Establece o devuelve el número máximo de registros permitidos en una sola página de un objeto de conjunto de registros |
| RecordCount | Devuelve el número de registros en un objeto de conjunto de registros |
| Sort | Establece o devuelve los nombres de campo en el conjunto de registros para ordenar |
| Source | Establece un valor de cadena o una referencia a un objeto de comando, o devuelve un valor de cadena que indica el origen de datos del objeto de conjunto de registros |
| State | Devuelve un valor que describe si el objeto de conjunto de registros está abierto, cerrado, de conexión, de ejecución o de la recuperación de datos |
| Status | Devuelve el estado del registro actual con respecto a las actualizaciones por lotes u otras operaciones masivas |
| StayInSync | Establece o devuelve si la referencia a los registros secundarios van a cambiar cuando cambia la posición del registro padre |
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 de un objeto de conjunto de registros |
| Clone | Crea un duplicado de un conjunto de registros existentes |
| Close | Cierra un conjunto de registros |
| CompareBookmarks | Compara dos marcadores |
| Delete | Borra un registro o un grupo de registros |
| Find | Las búsquedas de un registro en un conjunto de registros que satisface un criterio especificado |
| GetRows | Copias múltiples registros de un objeto de registros en una matriz de dos dimensiones |
| GetString | Devuelve un conjunto de registros como una cadena |
| Move | Mueve el puntero de registro en un objeto de conjunto de registros |
| 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 | Borra el objeto de registros actual y devuelve el siguiente objeto de registros por bucle a través de una serie de comandos |
| Open | Abre un elemento de base de datos que le da acceso a los registros de una tabla, los resultados de una consulta, o para un conjunto de registros salvado |
| Requery | Actualiza los datos en un conjunto de registros por volver a ejecutar la consulta que hizo el conjunto de registros originales |
| Resync | Renueva los datos de la corriente de registros de la base de datos original |
| Save | Guarda un objeto de conjunto de registros a un archivo o un objeto Stream |
| Seek | Busca el índice de un conjunto de registros para encontrar un registro que coincide con los valores especificados |
| Supports | Devuelve un valor booleano que define si o no un objeto Recordset soporta un tipo específico de funcionalidad |
| Update | Guarda todos los cambios realizados en un solo registro en un objeto de conjunto de registros |
| UpdateBatch | Guarda todos los cambios en un conjunto de registros a la base de datos. Se utiliza cuando se trabaja en el modo de actualización por lotes |
Eventos
Note: No se puede manejar eventos utilizando VBScript o JScript (sólo Visual Basic, Visual C ++ y Visual J ++ idiomas puede manejar eventos).
| Evento | Descripción |
|---|---|
| EndOfRecordset | Se activa cuando se intenta mover a un registro después del último registro |
| FetchComplete | Se activa después de todos los registros en una operación asíncrona han sido extraídas |
| FetchProgress | Se activa periódicamente en una operación asíncrona, para indicar cuántos registros más que han sido extraídas |
| FieldChangeComplete | Se activa después de que el valor de un cambio de objeto Campo |
| MoveComplete | Desencadenó después de la posición actual en el conjunto de registros ha cambiado |
| RecordChangeComplete | Activa después de un registro ha cambiado |
| RecordsetChangeComplete | Acciona después que el conjunto de registros ha cambiado |
| WillChangeField | Se activa antes de que el valor de un cambio de objeto Campo |
| WillChangeRecord | Desencadenada ante un cambio de registro |
| WillChangeRecordset | Se activa antes de un cambio de registros |
| Se moverá | Se activa antes de la posición actual en los cambios de registros |
Colecciones
| Colección | Descripción |
|---|---|
| Fields | Indica el número de objetos de campo en el objeto de conjunto de registros |
| Properties | Contiene todos los objetos propiedad del objeto de registros |
Propiedades de la colección de campos
| Propiedad | Descripción |
|---|---|
| Count | Devuelve el número de elementos de la colección de campos. Comienza en cero. Ejemplo: countfields = rs.Fields.Count |
| Item(named_item/number) | Devuelve un elemento especificado de la colección de campos. Ejemplo: itemfields = rs.Fields. Item(1) |
Propiedades de la colección Properties
| Propiedad | Descripción |
|---|---|
| Count | Devuelve el número de elementos de la colección de propiedades. Comienza en cero. Ejemplo: countprop = rs.Properties.Count |
| Item(named_item/number) | Devuelve un elemento especificado de la colección de propiedades. Ejemplo: itemprop = rs.Properties. Item(1) |