Article ID: 129856 - View products that this article applies to.
This article was previously published under Q129856
This article summarizes how to use the GetRows method in Visual Basic version 4.0.
The GetRows method was added to the RecordSet object to facilitate testing from Visual Basic of a lower-level C/C++ GetRows method that will be used by Visual C++ developers. It was later found to be generally useful in many places. This function is not documented in the Visual Basic Help file or the manuals, but can be found by using the Object Browser under the RecordSet object. It is described in the ReadMe file included with Visual Basic version 4.0.
The GetRows method retrieves multiple rows of a recordset into an array. Here is the syntax:
After a call to GetRows, the current record is positioned at the next unread row. In other words, GetRows has the same positioning effect as Move numrows.
If more rows are requested than are available, only the number available are returned. Use Ubound to determine how many rows were actually fetched. The array is sized to fit the number of rows returned.
For example, if you returned the results into a variant called a, you could use the following code to determine how many rows were actually returned:
The "+ 1" is used because the first data returned is in the zero (0) element of the array.
The number of rows that can be fetched is constrained by available memory and should be chosen to suit your application. Don't expect to use GetRows to bring your whole table into an array.
Because all fields of the recordset are returned in the array, including long memo and binary fields, you may want to use a query that restricts the columns returned.
Article ID: 129856 - Last Review: December 9, 2003 - Revision: 2.0