Compartir vía

Evento WillExecute (ADO)

  • Artículo

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

de origen de
Un string que contiene un comando SQL o un nombre de procedimiento almacenado.

cursorType
cursorTypeEnum que contiene el tipo de cursor para el recordset de que se abrirá. Con este parámetro, puede cambiar el cursor a cualquier tipo durante una operación de RecordsetOpen Method (ADO Recordset). cursorType se omitirá para cualquier otra operación.

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

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

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

pCommand
Objeto de Comando (ADO) objeto para el que se aplica esta notificación de evento.

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

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

Observaciones

Puede producirse un evento WillExecute debido a una conexión. Método Execute (Conexión ADO), Método Execute (Comando ADO), o Método Open (Recordset de ADO) método The pConnection parámetro siempre debe contener una referencia válida a un objeto Connection de. 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 Command de es una secuencia especificada por la propiedad CommandStream (ADO), asignando una nueva cadena a la WillExecuteparámetro Source cambia el origen del Command. La propiedad CommandStream se borrará y la propiedad CommandText (ADO) propiedad 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 de Dialecto (que corresponde al CommandStream), el dialecto correcto debe especificarse estableciendo la propiedad Dialecto del objeto de comando al que hace referencia pCommand.

Consulte también

Ejemplo del modelo de eventos de ADO de (VC++)
resumen del controlador de eventos de ADO
del objeto connection (ADO) de