Eventos WillExecute y ExecuteComplete de ADO
Definición y uso
El evento es un subproceso automático llamado después de que ocurre una operación específica.
- El evento WillExecute se desencadena antes de llamar a objcomm.Execute, objconn.Execute o objrs.Open.
- El evento ExecuteComplete se desencadena después de completar la llamada a objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery o objrs.NextRecordset.
Sintaxis
WillExecute src,cursortyp,locktyp,opciones,estado,objcomm,objrs,objconn ExecuteComplete refactored,objerror,estado,objcomm,objrs,objconn
| Descripción | |
|---|---|
| parámetro | cadena que contiene el nombre del comando SQL o del procedimiento almacenado. |
| cursortyp | especifica el tipo de cursor a usar.CursorTypeEnum uno de los valores. |
| locktyp | especifica el tipo de bloqueo a usar.LockTypeEnum uno de los valores. |
| opciones | uno o más CommandTypeEnum o ExecuteOptionEnum Valor |
| reaffected | Valor Long, número de registros afectados por el comando. |
| objerror |
Objeto Error que contiene errores ocurridos.
Notas: El valor de EventStatusEnum debe establecerse en adStatusErrorsOccurred para crear este objeto Error. |
| estado | un EventStatusEnum valor. |
| objcomm |
Para WillExecute: Si este evento se desencadena por Command.Execute, el parámetro objcomm referirá al objeto Command y el parámetro objrs se establecerá en Nothing. Para ExecuteComplete: El objeto Command ejecutado. |
| objrs |
Para WillExecute: si este evento se desencadena por Recordset.Open, el parámetro objrs referirá al objeto Recordset y el parámetro pCommand se configurará como Nothing. Para ExecuteComplete: el objeto Recordset, es el resultado de la ejecución del comando. |
| objconn | El objeto Connection asociado con la ejecución del comando. |
Valores de EventStatusEnum
| Constante | Valor | Descripción |
|---|---|---|
| adStatusOK | 1 | La acción que generó este evento tuvo éxito. |
| adStatusErrorsOccurred | 2 | La acción que generó este evento falló. |
| adStatusCantDeny | 3 | No se puede cancelar la acción suspendida. |
| adStatusCancel | 4 | Cancelar la acción que causó el evento. |
| adStatusUnwantedEvent | 5 | Prohibir notificaciones posteriores antes de que finalice la ejecución del método de evento. |
