ADO Open Method
❮ Complete Recordset Object Reference
The Open method opens a database element that gives you access to records in a table, the results of a query, or to a saved Recordset.
Tip: Always close the Recordset object after using it, to free system resources. Set the Recordset object to Nothing to completely eliminate it from memory.
Syntax
objRecordset.Open source,actconn,cursortyp,locktyp,opt
| Parameter | Description |
|---|---|
| source | Optional. Specifies a data source. The source parameter may be one of the following:
|
| actconn | Optional. A connection string or a Connection object |
| cursortyp | Optional. A CursorTypeEnum value that specifies the type of cursor to use when opening a Recordset object. Default is adOpenForwardOnly |
| locktyp | Optional. A LockTypeEnum value that specifies the type of locking on a Recordset object. Default is adLockReadOnly |
| opt | Optional. Specifies how to evaluate the source parameter if it is not a Command object. Can be one or more CommandTypeEnum or ExecuteOptionEnum values. |
Example
Open an ADO Table Recordset:
<%
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
set rs = Server.CreateObject("ADODB.recordset")
rs.Open "Customers", conn
%>
Open an ADO SQL Recordset:
<%
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
set rs = Server.CreateObject("ADODB.recordset")
rs.Open "Select * from Customers", conn
%>
CursorTypeEnum Values
| Constant | Value | Description |
|---|---|---|
| adOpenUnspecified | -1 | Unspecified type of cursor |
| adOpenForwardOnly | 0 | Default. A forward-only cursor. This improves performance when you need to make only one pass through a Recordset |
| adOpenKeyset | 1 | A keyset cursor. Like a dynamic cursor, except that you can't see records that other users add, although records that other users delete are inaccessible from your Recordset. Data changes by other users are still visible. |
| adOpenDynamic | 2 | A dynamic cursor. Additions, changes, and deletions by other users are visible, and all types of movement through the Recordset are allowed |
| adOpenStatic | 3 | A static cursor. A static copy of a set of records that you can use to find data or generate reports. Additions, changes, or deletions by other users are not visible. |
LockTypeEnum Values
| Constant | Value | Description |
|---|---|---|
| adLockUnspecified | -1 | Unspecified type of lock. Clones inherits lock type from the original Recordset. |
| adLockReadOnly | 1 | Default. Read-only records |
| adLockPessimistic | 2 | Pessimistic locking, record by record. The provider lock records immediately after editing |
| adLockOptimistic | 3 | Optimistic locking, record by record. The provider lock records only when calling update |
| adLockBatchOptimistic | 4 | Optimistic batch updates. Required for batch update mode |
CommandTypeEnum Values
| Constant | Value | Description |
|---|---|---|
| adCmdUnspecified | -1 | Unspecified type of command |
| adCmdText | 1 | Evaluates CommandText as a textual definition of a command or stored procedure call |
| adCmdTable | 2 | Evaluates CommandText as a table name whose columns are returned by an SQL query |
| adCmdStoredProc | 4 | Evaluates CommandText as a stored procedure name |
| adCmdUnknown | 8 | Default. Unknown type of command |
| adCmdFile | 256 | Evaluates CommandText as the file name of a persistently stored Recordset. Used with Recordset.Open or Requery only. |
| adCmdTableDirect | 512 | Evaluates CommandText as a table name whose columns are all returned. Used with Recordset.Open or Requery only. To use the Seek method, the Recordset must be opened with adCmdTableDirect. Cannot be combined with the ExecuteOptionEnum value adAsyncExecute. |
ExecuteOptionEnum Values
| Constant | Value | Description |
|---|---|---|
| adOptionUnspecified | -1 | Unspecified command |
| adAsyncExecute | 16 | The command should execute asynchronously. Cannot be combined with the CommandTypeEnum value adCmdTableDirect |
| adAsyncFetch | 32 | The remaining rows after the initial quantity specified in the CacheSize property should be retrieved asynchronously |
| adAsyncFetchNonBlocking | 64 | The main thread never blocks while retrieving. If the requested row has not been retrieved, the current row automatically moves to the end of the file. If you open a Recordset from a Stream containing a persistently stored Recordset, adAsyncFetchNonBlocking will not have an effect; the operation will be synchronous and blocking. adAsynchFetchNonBlocking has no effect when the adCmdTableDirect option is used to open the Recordset |
| adExecuteNoRecords | 128 | The command text is a command or stored procedure that does not return rows. If any rows are retrieved, they are discarded and not returned. adExecuteNoRecords can only be passed as an optional parameter to the Command or Connection Execute method |
| adExecuteStream | 256 | The results of a command execution should be returned as a stream. adExecuteStream can only be passed as an optional parameter to the Command Execute method |
| adExecuteRecord | 512 | The CommandText is a command or stored procedure that returns a single row which should be returned as a Record object |
❮ Complete Recordset Object Reference
Copyright 1999-2023 by Refsnes Data. All Rights Reserved.