Método GetRows (ADO)

Recupera varios registros de un objeto Recordset en una matriz.

Sintaxis

  
array = recordset.GetRows(Rows, Start, Fields )  

Valor devuelto

Devuelve un valor Variant cuyo valor es una matriz bidimensional.

Parámetros

Filas
Opcional. Valor GetRowsOptionEnum que indica el número de registros que se deben recuperar. El valor predeterminado es adGetRowsRest.

Iniciar
Opcional. Valor String o Variant que se evalúa como el marcador del registro desde el que debe comenzar la operación GetRows. También puede usar un valor BookmarkEnum.

Fields
Opcional. Un valor Variant que representa un nombre de campo único o una posición ordinal, o una matriz de nombres de campo o números de posición ordinal. ADO devuelve solo los datos de estos campos.

Comentarios

Use el método GetRows para copiar los registros de un objeto Recordset en una matriz bidimensional. El primer subíndice identifica el campo y el segundo identifica el número de registro. La variable de matriz se dimensiona 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 disponibles, GetRows devuelve solo el número de registros disponibles.

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

Si quiere restringir los campos que devuelve la llamada a GetRows, puede pasar un nombre o número de campo único o una matriz de nombres o números de campo en el argumento Fields.

Después de llamar a GetRows, el siguiente registro no leído se convierte en el registro actual, o bien la propiedad EOF se establece en True si no hay más registros.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

Ejemplo del método GetRows (VB)
Ejemplo del método GetRows (VC ++)