Compartir a través de

Método Execute (objeto Command de ADO)

  • Artículo

Se aplica a: Access 2013 | Access 2016

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

Sintaxis

Para un comando que devuelve un objeto Recordset:

Para un comando que no devuelve un objeto Recordset:

Valor devuelto

Devuelve una referencia a un objeto Recordset o Nothing.

Parameters

  • RecordsAffected

    • Es opcional. Variable Long a la que el proveedor devuelve el número de registros que se ven afectados por la operación. El parámetro RecordsAffected se aplica solo a las consultas de acción o a los procedimientos almacenados. RecordsAffected no devuelve el número de registros devueltos por un procedimiento almacenado o una consulta que devuelve resultados. Para obtener esta información, use la propiedad RecordCount. El método Execute no devolverá la información correcta cuando se utilice con adAsyncExecute, simplemente porque al ejecutarse un comando asincrónicamente, puede que aún se desconozca el número de registros afectados en el momento en que el método devuelve un valor.

  • Parameters

    • Es opcional. Matriz de tipo Variant de los valores de parámetro pasados con una instrucción SQL. (Los parámetros de salida no devolverán valores correctos cuando se pasen en este argumento.)

  • Options

    • Opcional. Valor de tipo Long que indica cómo el proveedor debe evaluar la propiedad CommandText del objeto Command. Puede ser un valor de máscara de bits formado con valores de CommandTypeEnum y/o ExecuteOptionEnum. Por ejemplo, puede utilizar adCmdText y adExecuteNoRecords conjuntamente si desea que ADO evalúe el valor de la propiedad CommandText como texto y si desea indicar que el comando debe descartar y no devolver ningún registro que pueda generarse cuando se ejecute el texto del comando.

Comentarios

Si se usa el método Execute en un objeto Command, se ejecuta la consulta especificada en la propiedad CommandText del objeto. Si la propiedad CommandText especifica una consulta que devuelve filas, los resultados generados por la consulta se almacenan en un nuevo objeto Recordset. Si el comando no es una consulta que devuelva filas, el proveedor devuelve un objeto Recordset cerrado. Algunos lenguajes de aplicación permiten omitir este valor devuelto si no se desea ningún objeto Recordset.

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

Nota:

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

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

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.