<Referencia completa de objeto de conexión
Un evento es una subrutina que se puede llamar de forma automática después de que haya tenido lugar una operación específica.
- El WillExecute caso puede ser despedido justo antes de una llamada a objcomm.Execute, objconn.Execute o objrs.Open.
- El ExecuteComplete caso puede ser despedido después de una llamada a objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery o objrs.NextRecordset se ha completado.
Sintaxis
WillExecute src,cursortyp,locktyp,options,
status,objcomm,objrs,objconn
ExecuteComplete recaffected,objerror,status,
objcomm,objrs,objconn
| Parámetro | Descripción |
|---|---|
| src | Una cadena que contiene un comando SQL o un nombre de procedimiento almacenado |
| cursortyp | Especifica el tipo de cursor a utilizar. Uno de los CursorTypeEnum valores |
| locktyp | Especifica el tipo de bloqueo a utilizar. Uno de los LockTypeEnum valores |
| options | Uno o más de los CommandTypeEnum o ExecuteOptionEnum valores |
| recaffected | El número de registros afectados por la ejecución |
| objerror | Un objeto de error que contiene los errores que se produjeron Note: El valor EventStatusEnum se debe establecer en adStatusErrorsOccurred para crear el objeto de error |
| status | Un EventStatusEnum valor |
| objcomm | Para WillExecute : Se establece en el objeto de comando que se ejecutó o Nada Para ExecuteComplete : El objeto de comando que se ejecuta |
| objrs | Para WillExecute : Se establece en el objeto de registros resultante de la ejecución del comando o Nada Para ExecuteComplete : El objeto Recordset que es el resultado del comando ejecutado |
| objconn | El objeto de conexión que se asocia con la ejecución de la orden |
Valores CursorTypeEnum
Especifica el tipo de cursor utilizado en un objeto de conjunto de registros.
| Constante | Valor | Descripción |
|---|---|---|
| adOpenUnspecified | -1 | No especifica el tipo de cursor. |
| adOpenForwardOnly | 0 | Defecto. Utiliza un cursor de sólo avance. Idéntica a un cursor estático, con la excepción de que sólo puede desplazarse hacia adelante a través de los registros. Esto mejora el rendimiento cuando se necesita para hacer una sola pasada a través de un conjunto de registros. |
| adOpenKeyset | 1 | Utiliza un cursor de conjunto de claves. Al igual que un cursor dinámico, excepto que no se puede ver registros que otros usuarios han añadido, a pesar de los registros que eliminan otros usuarios son inaccesibles desde el conjunto de registros. cambios en los datos de otros usuarios son todavía visibles. |
| adOpenDynamic | 2 | Utiliza un cursor dinámico. Las adiciones, modificaciones y supresiones de otros usuarios son visibles, y se les permite todo tipo de movimiento a través del conjunto de registros, a excepción de los marcadores, si el proveedor no los admite. |
| adOpenStatic | 3 | Utiliza un cursor estático. Una copia estática de un conjunto de registros que se pueden utilizar para buscar datos o generar informes. Las adiciones, modificaciones o supresiones de otros usuarios no son visibles. |
Valores LockTypeEnum
| Constante | Valor | Descripción |
|---|---|---|
| adLockUnspecified | -1 | No especifica un tipo de cerradura. Para los clones, el clon se crea con el mismo tipo de bloqueo que el original. |
| adLockReadOnly | 1 | Indica registros de sólo lectura. No se puede alterar los datos. |
| adLockPessimistic | 2 | Indica el bloqueo pesimista, registro por registro. El proveedor hace lo necesario para asegurar el éxito de edición de los registros, por lo general por los registros de bloqueo en la fuente de datos inmediatamente después de la edición. |
| adLockOptimistic | 3 | Indica optimista de bloqueo, registro por registro. El proveedor utiliza el bloqueo optimista, registros de bloqueo sólo cuando se llama al método de actualización. |
| adLockBatchOptimistic | 4 | Indica actualizaciones por lotes optimistas. Requerido para el modo de actualización por lotes. |
Valores CommandTypeEnum
| Constante | Valor | Descripción |
|---|---|---|
| adCmdUnspecified | -1 | No especifica el argumento de tipo comando. |
| adCmdText | 1 | Evalúa CommandText como una definición textual de un comando o llamada a procedimiento almacenado. |
| adCmdTable | 2 | Evalúa CommandText como un nombre de tabla cuyas columnas son todos devuelto por una consulta SQL generada internamente. |
| adCmdStoredProc | 4 | CommandText evalúa como un nombre de procedimiento almacenado. |
| adCmdUnknown | 8 | Indica que el tipo de comando en la propiedad CommandText no se conoce. |
| adCmdFile | 256 | Evalúa CommandText como nombre de archivo de un conjunto de registros almacenados persistentemente. Se utiliza con Recordset.Open o Requery solamente. |
| adCmdTableDirect | 512 | Evalúa CommandText como una tabla de nombres cuyas columnas son todos regresaron. Se utiliza con Recordset.Open o Requery solamente. Para utilizar el método Seek, el conjunto de registros debe abrirse con adCmdTableDirect. Este valor no se puede combinar con el valor ExecuteOptionEnum adAsyncExecute. |
Valores ExecuteOptionEnum
| Constante | Valor | Descripción |
|---|---|---|
| adOptionUnspecified | -1 | Indica que el comando está especificado. |
| adAsyncExecute | 16 | Indica que el comando debe ejecutarse de forma asíncrona. Este valor no se puede combinar con el valor adCmdTableDirect CommandTypeEnum. |
| adAsyncFetch | 32 | Indica que las filas restantes después de la cantidad inicial especificado en la propiedad CacheSize deben ser recuperados de forma asíncrona. |
| adAsyncFetchNonBlocking | 64 | Indica que el hilo principal nunca se bloquea al recuperar. Si la fila solicitada no se ha recuperado, la fila actual se mueve automáticamente al final del archivo. Si abre un conjunto de registros de una corriente que contiene un conjunto de registros almacenados persistentemente, adAsyncFetchNonBlocking no tendrá un efecto; la operación será síncrona y el bloqueo. adAsynchFetchNonBlocking no tiene efecto cuando la opción adCmdTableDirect se utiliza para abrir el conjunto de registros. |
| adExecuteNoRecords | 128 | Indica que el texto del comando es un comando o un procedimiento almacenado que no devuelve filas (for example, a command that only inserts data) . Si se recuperan las filas, se descartan y no regresaron. adExecuteNoRecords solamente se puede pasar como un parámetro opcional para el comando o de conexión Ejecutar método. |
| adExecuteStream | 256 | Indica que los resultados de una ejecución de comandos deben ser devueltos como una corriente. adExecuteStream solamente se puede pasar como un parámetro opcional para el comando EXECUTE método. |
| adExecuteRecord | 512 | Indica que el CommandText es una instrucción o un procedimiento almacenado que devuelve una sola fila que debe ser devuelto como un objeto de registro. |
Valores EventStatusEnum
| Constante | Valor | Descripción |
|---|---|---|
| adStatusOK | 1 | La operación que generó el evento fue un éxito |
| adStatusErrorsOccurred | 2 | La operación que generó el evento no pudo |
| adStatusCantDeny | 3 | No se puede cancelar la operación pendiente |
| adStatusCancel | 4 | Cancela la operación que generó el evento |
| adStatusUnwantedEvent | 5 | Evita que las notificaciones posteriores antes de que el método de evento ha finalizado la ejecución |
<Referencia completa de objeto de conexión