Método GetRows (ADO)

Se aplica a: Access 2013, Office 2013

Recupera varios registros de un objeto Recordset en una matriz.

Sintaxis

Matriz = conjunto de registros. GetRows(Rows, Start, Fields )

Valor devuelto

Devuelve un valor de tipo Variant que es una matriz bidimensional.

Parámetros

Parámetro	Descripción
Rows	Es opcional. Valor de GetRowsOptionEnum que indica el número de registros que se van a recuperar. El valor predeterminado es adGetRowsRest.
Start	Es opcional. Valor de tipo String o Variant que se establece en el marcador del registro donde debe iniciar la operación de GetRows. También puede utilizar un valor de BookmarkEnum.
Fields	Es opcional. Variant que representa el nombre o la posición ordinal de un solo campo, o bien, una matriz de nombres de campo o números de posición ordinal. ADO devuelve sólo los datos de estos campos.

Comentarios

Use el método GetRows para copiar los registros de un objeto Recordset a una matriz bidimensional. El primer subíndice identifica el campo y el segundo identifica el número de registro. La variable de matriz se ajusta automáticamente al tamaño correcto cuando el método GetRows devuelve los datos.

Si no especifica un valor para el argumento Rows, el método GetRows recupera automáticamente todos los registros del objeto Recordset. Si solicita más registros de los que están disponibles, GetRows devuelve sólo el número de registros disponibles.

Si el objeto Recordset admite marcadores, puede especificar en qué registro el método GetRows debe comenzar a recuperar datos pasando el valor de la propiedad Bookmark de ese registro en el argumento Start.

Si desea restringir los campos que debe devolver la llamada a GetRows, puede pasar el número o el nombre de un solo campo, o bien, una matriz de números y nombres de campo en el argumento Fields.

Tras llamar a GetRows, el siguiente registro sin leer se convierte en el registro actual, o bien, el valor de la propiedad EOF se establece en True si no quedan registros.