ADO Execute Method
 Complete Connection Object Reference
The Execute method executes a specified query, SQL statement, stored procedure, or provider-specific
text.
The results are stored in a new Recordset object if it is a row-returning
query. A closed Recordset object will be returned if it is not a row-returning
query.
Note: The returned Recordset is always a read-only, forward-only
Recordset!
Tip: To create a Recordset with more functionality, first create a
Recordset object. Set the desired properties, and then use the Recordset
object's Open method to execute the query.
Syntax for row-returning
Set objrs=objconn.Execute(commandtext,ra,options)
|
Syntax for non-row-returning
objconn.Execute commandtext,ra,options
|
| Parameter |
Description |
| commandtext |
Required. The SQL statement, stored procedure, or provider-specific text to
execute |
| ra |
Optional. The number of records
affected by the query
|
| options |
Optional. Sets how the provider should evaluate the commandtext parameter. Can be one or more CommandTypeEnum or
ExecuteOptionEnum
values. Default is adCmdUnspecified
|
Example
<%
sql="SELECT companyname FROM Customers"
Set rs=conn.Execute(sql)
%>
|
CommandTypeEnum Values
| Constant |
Value |
Description |
| adCmdUnspecified |
-1 |
Does not specify the command type argument. |
| 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 all returned
by an internally generated SQL query. |
| adCmdStoredProc |
4 |
Evaluates CommandText as a stored procedure name. |
| adCmdUnknown |
8 |
Indicates that the type of command in the CommandText
property is not known. |
| 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. This value cannot be
combined with the ExecuteOptionEnum value adAsyncExecute. |
ExecuteOptionEnum Values
| Constant |
Value |
Description |
| adOptionUnspecified |
-1 |
Indicates that the command is unspecified. |
| adAsyncExecute |
|
Indicates that the command should execute asynchronously. This value
cannot be combined with the CommandTypeEnum value adCmdTableDirect. |
| adAsyncFetch |
|
Indicates that the remaining rows after the initial quantity specified
in the CacheSize property should be retrieved asynchronously. |
| adAsyncFetchNonBlocking |
|
Indicates that 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 |
|
Indicates that the command text is a command or stored procedure that
does not return rows (for example, a command that only inserts data). 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 |
|
Indicates that 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 |
|
Indicates that the CommandText is a command or stored procedure that
returns a single row which should be returned as a Record object. |
Complete Connection Object Reference
The Ektron Intranet
lets you do everything you need to do on your corporate intranet and everything you want to do... all with just one application.
What can you do with the Ektron Intranet? |
|
Navigate through content, documents, assets, colleagues and workgroups quickly and intuitively with enterprise search |
|
Communicate with friends and colleagues with forums, message boards and corporate blogging using the new Social Networking Platform |
|
Promote collaboration among coworkers in your organization through project workspaces where others can efficiently find information and work together |
|
Personalize your company profile by bookmarking and organizing favorite content, uploading assets, posting photos, blogging, and more |
|
Interact with features like tagging, flagging, wikis and ratings found in the Web 2.0 Toolbox |
 |
Author/edit content, manage navigation, menus, audit trails, workflow and approvals with the best in breed Content Management |
|
|
|
|
See why there are 20,000+ Ektron integrations worldwide.
Request an
INSTANT DEMO or download a
FREE TRIAL today. |
|
HOME
Printer friendly page
