Compartir a través de

Método Execute (objeto Connection de ADO)

  • Artículo

Se aplica a: Access 2013 | Access 2016

Ejecuta la consulta, la instrucción SQL, el procedimiento almacenado o texto específico del proveedor.

Sintaxis

Para una cadena de comandos que no devuelve filas:

conexión. EjecutarCommandText, RecordsAffected, Options

Para una cadena de comandos que devuelve filas:

Establezca laconexióndel conjunto de registros = .Execute( CommandText, RecordsAffected, Options )

Valor devuelto

Devuelve una referencia al objeto Recordset.

Parameters

  • CommandText

    • Valor de tipo String que contiene la instrucción SQL, el procedimiento almacenado, la dirección URL o el texto específico del proveedor que se va a ejecutar. De manera opcional, se pueden utilizar nombres de tabla, pero sólo si el proveedor reconoce SQL. Por ejemplo, si se utiliza el nombre de tabla "Clientes", ADO antepondrá automáticamente la sintaxis estándar Select de SQL para formar y pasar al proveedor "SELECT * FROM Clientes" como una instrucción T-SQL.

  • RecordsAffected

    • Es opcional. Variable de tipo Long a la que el proveedor devuelve el número de registros afectados por la operación.

  • Options

    • Opcional. Valor de tipo Long que indica cómo el proveedor debe evaluar el argumento CommandText. Puede ser una máscara de bits de uno o varios valores de CommandTypeEnum o ExecuteOptionEnum.

Nota:

[!NOTA] Utilice el valor adExecuteNoRecords de ExecuteOptionEnum para minimizar el procesamiento interno y así mejorar el rendimiento.

No use los valores adCmdFile ni adCmdTableDirect de CommandTypeEnum con Execute. Estos valores se pueden usar únicamente como opciones con los métodos Open y Requery de un objeto Recordset.

Comentarios

Si se usa el método Execute en un objeto Connection, se ejecuta cualquier consulta que se pase al método en el argumento CommandText en la conexión especificada. Si el argumento CommandText especifica una consulta que devuelve filas, los resultados generados por la consulta se almacenan en un objeto Recordset nuevo. 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.

El objeto Recordset devuelto siempre es un cursor de solo lectura y de solo avance. Si necesita un objeto Recordset con mayor funcionalidad, cree primero un objeto Recordset con los valores de propiedad deseados y, a continuación, utilice el método Open del objeto Recordset para ejecutar la consulta y devolver el tipo de cursor deseado.

El contenido del argumento CommandText es específico del proveedor y puede ser una sintaxis SQL estándar o cualquier formato de comando especial que admita el proveedor.

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

Nota:

[!NOTA] Las direcciones URL que utilizan el esquema http llamarán automáticamente a Microsoft OLE DB Provider for Internet Publishing. Para obtener más información, vea Direcciones URL absolutas y relativas.

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.