Indicates the type of a Command object.
Settings and Return Values
Sets or returns one of the following CommandTypeEnum values.
Constant | Description |
adCmdText | Evaluates CommandText as a textual definition of a command or stored procedure call. |
adCmdTable | Evaluates CommandText as a table name whose columns are all returned by an internally generated SQL query. |
adCmdTableDirect | Evaluates CommandText as a table name whose columns are all returned. |
adCmdStoredProc | Evaluates CommandText as a stored procedure name. |
adCmdUnknown | Default. The type of command in the CommandText property is not known. |
adCommandFile | Evaluates CommandText as the file name of a persisted Recordset. |
adExecuteNoRecords | Indicates CommandText 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. Always combined with adCmdText or adCmdStoredProc. |
Remarks
Use the CommandType property to optimize evaluation of the CommandText property.
If the CommandType property value equals adCmdUnknown (the default value), you may experience diminished performance because ADO must make calls to the provider to determine if the CommandText property is an SQL statement, a stored procedure, or a table name. If you know what type of command you're using, setting the CommandType property instructs ADO to go directly to the relevant code. If the CommandType property does not match the type of command in the CommandText property, an error occurs when you call the Execute method.
The adExecuteNoRecords constant improves performance by minimizing internal processing. This constant never stands alone; it is always combined with adCmdText or adCmdStoredProc (for example, adCmdText+adExecuteNoRecords
). An error results if adExecuteNoRecords is used with the Recordset.Open method, or a Command object used by that method.