Evento WillExecute (ADO)

Se llama al evento WillExecute justo antes de que se ejecute un comando pendiente en una conexión.

Sintaxis

  
WillExecute Source, CursorType, LockType, Options, adStatus, pCommand, pRecordset, pConnection  

Parámetros

Origen
Cadena que contiene un comando SQL o un nombre de procedimiento almacenado.

CursorType
CursorTypeEnum que contiene el tipo de cursor del Recordset que se abrirá. Con este parámetro, puede cambiar el cursor a cualquier tipo durante una operación de método abierto Recordset (ADO Recordset)Recordset. CursorType se omitirá para cualquier otra operación.

LockType
LockTypeEnum que contiene el tipo de bloqueo del objeto Recordset que se abrirá. Con este parámetro, puede cambiar el bloqueo a cualquier tipo durante una operación RecordsetOpen. LockType se omitirá para cualquier otra operación.

Opciones
Valor Long que indica las opciones que se pueden usar para ejecutar el comando o abrir el objeto Recordset.

adStatus
Valor de estado EventStatusEnum que puede ser adStatusCantDeny o adStatusOK cuando se llama a este evento. Si es adStatusCantDeny, este evento no puede solicitar la cancelación de la operación pendiente.

pCommand
Objeto Command (ADO) para el que se aplica esta notificación de eventos.

pRecordset
Objeto Recordset (ADO) para el que se aplica esta notificación de eventos.

pConnection
Objeto Connection (ADO) para el que se aplica esta notificación de eventos.

Comentarios

Un evento WillExecute puede producirse debido a una conexión. Método Execute (Conexión de ADO),Método Execute (Comando ADO) o Método Open (Recordset de ADO) El parámetro pConnection siempre debe contener una referencia válida a un objeto Connection. Si el evento se debe a Connection.Execute, los parámetros pRecordset y pCommand se establecen en Nothing. Si el evento se debe a Recordset.Open, el parámetro pRecordset hará referencia al objeto Recordset y el parámetro pCommand se establece en Nothing. Si el evento se debe a Command.Execute, el parámetro pCommand hará referencia al objeto Command y el parámetro pRecordset se establece en Nothing.

WillExecute permite examinar y modificar los parámetros de ejecución pendientes. Este evento puede devolver una solicitud de cancelación del comando pendiente.

Nota

Si el origen original de un comando es una secuencia especificada por la propiedad CommandStream (ADO), la asignación de una nueva cadena al parámetro WillExecuteSource cambia el origen del comando. La propiedad CommandStream se borrará y la propiedad CommandText (ADO) se actualizará con el nuevo origen. Se liberará la secuencia original especificada por CommandStream y no se podrá acceder a ella.

Si el dialecto de la nueva cadena de origen difiere del valor original de la propiedad Dialect Property (que corresponde a CommandStream), el dialecto correcto debe especificarse estableciendo la propiedad Dialect del objeto de comando al que hace referencia pCommand.

Consulte también

Ejemplo de modelo de eventos de ADO (VC ++)
Conexión ADO y los eventos de conjunto de registros
Objeto de conexión (ADO)