Execute (método) (conexión de ADO)

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

Sintaxis

  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  

Valor devuelto

Devuelve una referencia de objeto Conjunto de registros de objeto (ADO).

Parámetros

CommandText
Un valor de Cadena que contiene la instrucción SQL, el procedimiento almacenado, una dirección URL o un texto específico del proveedor que se va a ejecutar. Opcionalmente, se pueden usar nombres de tabla, pero solo si el proveedor reconoce SQL. Por ejemplo, si se usa un nombre de la tabla "Customers", ADO antepone automáticamente la sintaxis estándar SQL Select para formar y pasar "SELECT * FROM Customers" como una instrucción Transact-SQL al proveedor.

RecordsAffected
Opcional. Una variable Long a la que el proveedor devuelve el número de registros afectados por la operación.

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

Nota Use el valor ExecuteOptionEnumadExecuteNoRecords para mejorar el rendimiento al minimizar el procesamiento interno y de las aplicaciones que se van a migrar desde Visual Basic 6.0.

No use adExecuteStream con el método Execute de un objeto Connection.

No use los valores CommandTypeEnum de adCmdFile o adCmdTableDirect con Execute. Estos valores solo se pueden usar como opciones con los métodos Open (método) (Conjunto de registros de ADO) y Requery (método) de un Conjunto de registros.

Comentarios

El uso del método Execute en un objeto Objeto de conexión (ADO) ejecuta cualquier consulta que pase al método en el argumento CommandText de la conexión especificada. Si el argumento CommandText especifica una consulta que devuelve filas, los resultados que genera la ejecución se almacenan en un nuevo objeto Conjunto de registros. 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 uno cerrado Conjunto de registros.

El objeto Conjunto de registros devuelto siempre es un cursor de solo lectura y de solo avance. Si necesita un objeto del Conjunto de registros con más funcionalidad, cree primero un objeto Conjunto de registros con la configuración de propiedad deseada y, a continuación, use el Conjunto de registros del objeto Open (método) (Conjunto de registros de ADO) para ejecutar la consulta y devolver el tipo de cursor deseado.

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

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

Nota

Las URL que usan el esquema http invocan automáticamente el Proveedor de Microsoft OLE DB para publicaciones en Internet. Para obtener más información, vea Direcciones URL absolutas y relativas.

Se aplica a

Objeto de conexión (ADO)