PRB: MaxRecords Property Not Used in Access Queries with ADO

ID: Q186267

The information in this article applies to:

ActiveX Data Objects (ADO), versions 1.0, 1.5, 2.0, 2.1 SP2

SYMPTOMS

Using the MaxRecords property of an ADO Recordset object does not affect the number of records returned in queries against Microsoft Access databases.

CAUSE

The MaxRecords property depends on functionality exposed by the underlying OLE DB provider or ODBC driver to limit the number of rows returned by the query. This functionality is optional for ODBC drivers and OLE DB providers. The Microsoft Access ODBC driver and Jet OLEDB provider do not expose this functionality. This behavior may occur for other OLE DB providers and ODBC drivers as well.

RESOLUTION

If you want to limit the number of records returned in a query against a Microsoft Access database, use the TOP syntax in the query string rather than the Recordset's MaxRecords property.

STATUS

This behavior is by design.

MORE INFORMATION

Steps to Reproduce Behavior

Instead of using the following code:


   strSQL = "SELECT * FROM Customers"
   rsCustomers.MaxRecords = 10
   rsCustomers.Open strSQL, cnNWind, adOpenStatic
   MsgBox rsCustomers.RecordCount & " records returned using MaxRecords."

Use this code:


   strSQL = "SELECT TOP 10 * FROM Customers"
   rsCustomers.Open strSQL, cnNWind, adOpenStatic
   MsgBox rsCustomers.RecordCount & " records returned using TOP syntax."

With the first snippet of code, you should see that the MaxRecords property does not affect the number of records returned by the query. The second snippet of code should return only ten records.

Additional query words:

Keywords : kbADO kbDatabase kbDCOM kbJET kbMTS kbODBC kbOLEDB kbVBp600 kbGrpVBDB kbGrpMDAC kbADO210sp2 kbMDAC210SP2
Version : WINDOWS:1.0,1.5,2.0,2.1 SP2
Platform : WINDOWS
Issue type : kbprb