CommandType Property (ADO)

   Example   Applies To   

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.