Tutorials References Menu

ADO GetRows Method


❮ Complete Recordset Object Reference

The GetRows method copies multiple records from a Recordset object into a two-dimensional array.

Syntax

vararray=objRecordset.GetRows(rows,start,fields)

Parameter Description
rows Optional. A GetRowsOptionEnum value that specifies the number of records to retrieve. Default is adGetRowsRest.

Note: If you omit this argument it will retrieve all records in the Recordset

start

Optional. What record to start on, a record number or a BookmarkEnum value

fields Optional. If you want to specify only the fields that the GetRows call will return, it is possible to pass a single field name/number or an array of field names/numbers in this argument

Example

<%
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open(Server.Mappath("northwind.mdb"))
set rs = Server.CreateObject("ADODB.recordset")
rs.Open "Select * from Customers", conn

'The first number indicates how many records to copy
'The second number indicates what recordnumber to start on
p=rs.GetRows(2,0)
rs.close
conn.close

'This example returns the value of the first
'column in the first two records
response.write(p(0,0))
response.write("<br>")
response.write(p(0,1))

'This example returns the value of the first
'three columns in the first record
response.write(p(0,0))
response.write("<br>")
response.write(p(1,0))
response.write("<br>")
response.write(p(2,0))
%>

GetRowsOptionEnum Values

Constant Value Description
adGetRowsRest -1 Retrieves the rest of the records in the Recordset object

BookmarkEnum Values

Constant Value Description
adBookmarkCurrent 0 Starts at the current record
adBookmarkFirst 1 Starts at the first record
adBookmarkLast 2 Starts at the last record

❮ Complete Recordset Object Reference