Tutorials References Menu

ADO CursorLocation Property


❮ Complete Connection Object Reference

The CursorLocation property sets or returns a long value that indicates the location of the cursor service. It can be set to one of the CursorLocationEnum values. Default value is AdUseServer.

A cursor is used to:

  • control record navigation
  • control the visibility of changes in the database
  • control the updatability of data

Note: A Recordset object inherits this setting from the associated Connection object.

Note: This property is read-only on an open Recordset object, and read/write on a Connection object or on a closed Recordset object.


Syntax

objConnection.CursorLocation
objRecordset.CursorLocation

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")
sql="SELECT * FROM Customers"

rs.CursorLocation=adUseClient
rs.CursorType=adOpenStatic
rs.LockType=adLockBatchOptimistic

rs.Open sql,conn

rs.Close
conn.Close
%>

CursorLocationEnum Values

Constant Value Description
adUseNone 1 OBSOLETE (appears only for backward compatibility). Does not use cursor services
adUseServer 2 Default. Uses a server-side cursor
adUseClient 3 Uses a client-side cursor supplied by a local cursor library. For backward compatibility, the synonym adUseClientBatch is also supported

❮ Complete Connection Object Reference