ADO Execute Method


❮ Complete Command Object Reference

The Execute method executes the query, SQL statement or procedure specified in the CommandText property of the Command object.

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. 

Syntax for row-returning

Set rs=objcommand.Execute(ra,parameters,options)

Syntax for non-row-returning

objcommand.Execute ra,parameters,options

Parameter Description
ra Optional. Returns the number of records affected by a query. For a row-returning query, use the RecordCount property of the Recordset object to count of how many records are in the object.
parameters Optional. Parameter values passed with an SQL statement. Used to change, update, or insert new parameter values into the Parameters Collection.
options Optional. Sets how the provider should evaluate the CommandText property. Can be one or more CommandTypeEnum or ExecuteOptionEnum values. Default is adCmdUnspecified. 

Example

<%
Set objcommand.CommandText="SELECT * FROM Customers"
objCommand.Execute
%>

or

<%
Set objcommand.CommandText="Customers"
objCommand.Execute(,,adCmdTableDirect)
%>

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 Command Object Reference
Copyright 1999-2023 by Refsnes Data. All Rights Reserved.