Método Execute (Command ADO)

Ejecuta la consulta, la instrucción SQL o el procedimiento almacenado especificados en la propiedad CommandText o CommandStream del objeto Command.

Sintaxis

  
Set recordset = command.Execute( RecordsAffected, Parameters, Options )  

Valor devuelto

Devuelve una referencia de objeto Recordset, una secuencia o Nothing.

Parámetros

RecordsAffected
Opcional. Variable Long a la que el proveedor devuelve el número de registros afectados por la operación. El parámetro RecordsAffected solo se aplica a las consultas de acción o a los procedimientos almacenados. RecordsAffected no devuelve el número de registros devueltos por una consulta de devolución de resultados o un procedimiento almacenado. Para obtener esta información, utilice la propiedad RecordCount. El método Execute no devolverá la información correcta cuando se usa con adAsyncExecute, simplemente porque cuando se ejecuta un comando de forma asincrónica, es posible que todavía no se conozca el número de registros afectados en el momento en que el método devuelve.

Parámetros
Opcional. Matriz Variant de valores de parámetro utilizados junto con la cadena de entrada o secuencia especificada en CommandText o CommandStream. (Los parámetros de salida no devolverán valores correctos cuando se pasen en este argumento).

Opciones
Opcional. Valor Long que indica cómo el proveedor debe evaluar commandText o la propiedad CommandStream del objeto Command. Puede ser un valor de máscara de bits realizado mediante los valores CommandTypeEnum o ExecuteOptionEnum. Por ejemplo, puede usar adCmdText y adExecuteNoRecords en combinación si desea que ADO evalúe el valor de la propiedad CommandText como texto e indique que el comando debe descartar y no devolver ningún registro que se pueda generar cuando se ejecute el texto del comando.

Nota

Use el valor executeOptionEnumadExecuteNoRecords para mejorar el rendimiento minimizando el procesamiento interno. Si se especificó adExecuteStream, se omiten las opciones adAsyncFetch y adAsynchFetchNonBlocking. No use los valores CommandTypeEnum de adCmdFile o adCmdTableDirect con Execute. Estos valores solo se pueden usar como opciones con los métodos Open y Requery de un objeto Recordset.

Comentarios

El uso del método Execute en un objeto Command ejecuta la consulta especificada en la propiedad CommandText o la propiedad CommandStream del objeto.

Los resultados se devuelven en un objeto Recordset (de forma predeterminada) o como una secuencia de información binaria. Para obtener una secuencia binaria, especifique adExecuteStream en Opciones y, a continuación, proporcione un flujo estableciendo Command.Properties("Output Stream"). Se puede especificar un objeto Stream de ADO para recibir los resultados u otro objeto de secuencia, como el objeto Response de IIS. Si no se especificó ninguna secuencia antes de llamar a Execute con adExecuteStream, se produce un error. La posición de la secuencia devuelta desde Execute es específica del proveedor.

Si el comando no está pensado para devolver resultados (por ejemplo, una consulta SQL UPDATE), el proveedor devuelve Nothing siempre y cuando se especifique la opción adExecuteNoRecords; de lo contrario, Execute devuelve un objeto Recordset cerrado. Algunos lenguajes de aplicación permiten omitir este valor devuelto si no se desea ningún objeto Recordset.

Execute genera un error si el usuario especifica un valor para CommandStream cuando CommandType es adCmdStoredProc, adCmdTable o adCmdTableDirect.

Si la consulta tiene parámetros, se usan los valores actuales de los parámetros del objeto Command a menos que los invalide con valores de parámetro pasados con la llamada Execute. Puede invalidar un subconjunto de los parámetros omitiendo nuevos valores para algunos de los parámetros al llamar al método Execute. El orden en el que se especifican los parámetros es el mismo orden en el que el método los pasa. Por ejemplo, si hubiera cuatro parámetros (o más) y quisiera pasar nuevos valores solo para los primeros y cuartos parámetros, pasaría Array(var1,,,var4) como argumento Parameters.

Nota

(Los parámetros de salida no devolverán valores correctos cuando se pasen en el argumento Parameters).

Se emitirá un evento ExecuteComplete cuando finalice esta operación.

Nota

Al emitir comandos que contengan direcciones URL, los que usan el esquema http invocarán automáticamente el proveedor OLE DB de Microsoft para publicación en Internet. Para obtener más información, véase Direcciones URL absolutas y relativas.

Se aplica a

Objeto Command (ADO)

Consulte también

Ejemplo de los métodos Execute, Requery y Clear (VB)
Ejemplo de métodos Execute, Requery y Clear (VBScript)
Ejemplo de métodos Execute, Requery y Clear (VC++)
Propiedad CommandStream (ADO)
Propiedad CommandText (ADO)
CommandTypeEnum
Execute (método) (conexión de ADO)
Evento ExecuteComplete (ADO)