<Completa Connection Object Reference
Um evento é uma sub-rotina que pode ser chamado automaticamente após a ocorrência de uma operação específica.
- O WillExecute evento pode ser acionado imediatamente antes de uma chamada para objcomm.Execute, objconn.Execute, ou objrs.Open.
- O ExecuteComplete evento pode ser acionado após uma chamada para objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery, ou objrs.NextRecordset está concluída.
Sintaxe
WillExecute src,cursortyp,locktyp,options,
status,objcomm,objrs,objconn
ExecuteComplete recaffected,objerror,status,
objcomm,objrs,objconn
| Parâmetro | Descrição |
|---|---|
| src | Uma seqüência que contém um comando SQL ou um nome de procedimento armazenado |
| cursortyp | Especifica o tipo de cursor para ser usado. Um dos CursorTypeEnum valores |
| locktyp | Especifica o tipo de bloqueio para ser utilizado. Um dos LockTypeEnum valores |
| options | Um ou mais do CommandTypeEnum ou ExecuteOptionEnum valores |
| recaffected | O número de registros afetados pela execução |
| objerror | Um objeto de erro que contém os erros que ocorreram Note: O valor EventStatusEnum deve ser definido como adStatusErrorsOccurred para criar o objeto de erro |
| status | Um EventStatusEnum valor |
| objcomm | Para WillExecute : Ajuste para o objeto de comando que foi executado ou Nada Para ExecuteComplete : O objeto de comando que foi executado |
| objrs | Para WillExecute : Defina como o objeto Recordset que resultou da execução do comando ou Nada Para ExecuteComplete : O objeto Recordset que é o resultado do comando executado |
| objconn | O objeto de conexão que está associado com a execução do comando |
Valores CursorTypeEnum
Especifica o tipo de cursor usado num objecto de registos.
| Constante | Valor | Descrição |
|---|---|---|
| adOpenUnspecified | -1 | não especifica o tipo de cursor. |
| adOpenForwardOnly | 0 | Padrão. Utiliza um cursor só de frente. Idêntico a um cursor estático, exceto que você só pode rolar para a frente através de registros. Isso melhora o desempenho quando você precisa fazer apenas uma passagem através de um conjunto de registos. |
| adOpenKeyset | 1 | Usa um cursor de conjunto de chaves. Como um cursor dinâmico, exceto que você não pode ver registros que outros usuários adicionar, embora os registros que outros usuários excluir são inacessíveis a partir do seu conjunto de registos. As alterações de dados por outros usuários ainda são visíveis. |
| adOpenDynamic | 2 | Usa um cursor dinâmico. Adições, alterações e exclusões por outros usuários são visíveis, e são permitidos todos os tipos de movimento através do conjunto de registos, com exceção de marcadores, se o provedor não apoiá-los. |
| adOpenStatic | 3 | Usa um cursor estático. Uma cópia estática de um conjunto de registros que você pode usar para localizar dados ou gerar relatórios. Adições, alterações ou supressões por outros usuários não são visíveis. |
Valores LockTypeEnum
| Constante | Valor | Descrição |
|---|---|---|
| adLockUnspecified | -1 | não especifica um tipo de bloqueio. Para os clones, o clone é criado com o mesmo tipo de bloqueio que o original. |
| adLockReadOnly | 1 | Indica somente leitura registros. Você não pode alterar os dados. |
| adLockPessimistic | 2 | Indica bloqueio pessimista, ficha por ficha. O provedor faz o que é necessário para assegurar a edição bem sucedida dos registros, geralmente por registros de travamento na fonte de dados imediatamente após a edição. |
| adLockOptimistic | 3 | Indica bloqueio otimista, registro por registro. O provedor utiliza o bloqueio otimista, registros de bloqueio somente quando você chamar o método Update. |
| adLockBatchOptimistic | 4 | Indica atualizações em lote otimistas. Necessário para modo de atualização em lote. |
Valores CommandTypeEnum
| Constante | Valor | Descrição |
|---|---|---|
| adCmdUnspecified | -1 | Não especifica o argumento de tipo de comando. |
| adCmdText | 1 | Avalia CommandText como uma definição textual de um comando ou chamada de procedimento armazenado. |
| adCmdTable | 2 | Avalia CommandText como um nome da tabela cujas colunas são retornados por uma consulta SQL gerado internamente. |
| adCmdStoredProc | 4 | Avalia CommandText como um nome de procedimento armazenado. |
| adCmdUnknown | 8 | Indica que o tipo de comando na propriedade CommandText não é conhecido. |
| adCmdFile | 256 | Avalia CommandText como o nome de um conjunto de registos armazenadas permanentemente arquivo. Usado com apenas Recordset.Open ou Requery. |
| adCmdTableDirect | 512 | Avalia CommandText como um nome da tabela cujas colunas são todos devolvidos. Usado com apenas Recordset.Open ou Requery. Para usar o método Seek, o conjunto de registros deve ser aberto com adCmdTableDirect. Este valor não pode ser combinado com o valor ExecuteOptionEnum adAsyncExecute. |
Valores ExecuteOptionEnum
| Constante | Valor | Descrição |
|---|---|---|
| adOptionUnspecified | -1 | Indica que o comando não é especificado. |
| adAsyncExecute | 16 | Indica que o comando deve ser executado de forma assíncrona. Este valor não pode ser combinado com o valor adCmdTableDirect CommandTypeEnum. |
| adAsyncFetch | 32 | Indica que as linhas restantes após a quantidade inicial especificado na propriedade CacheSize devem ser recuperadas de forma assíncrona. |
| adAsyncFetchNonBlocking | 64 | Indica que o segmento principal nunca bloqueia a durante a recuperação. Se a linha solicitada não tiver sido recuperada, a linha atual se move automaticamente para o final do arquivo. Se você abrir um conjunto de registos a partir de um fluxo que contém um conjunto de registos armazenadas permanentemente, adAsyncFetchNonBlocking não terá um efeito; a operação vai ser síncronas e de bloqueio. adAsynchFetchNonBlocking não tem efeito quando a opção adCmdTableDirect é usado para abrir o conjunto de registos. |
| adExecuteNoRecords | 128 | Indica que o texto de comando é um comando ou procedimento armazenado que não retorna linhas (for example, a command that only inserts data) . Se as linhas são recuperadas, elas são descartadas e não retornou. adExecuteNoRecords só pode ser passado como um parâmetro opcional para o comando ou Connection método de execução. |
| adExecuteStream | 256 | Indica que os resultados de uma execução de comando deve ser retornado como um riacho. adExecuteStream só pode ser passado como um parâmetro opcional para o comando método de execução. |
| adExecuteRecord | 512 | Indica que o CommandText é um comando ou procedimento armazenado que retorna uma única linha que deve ser retornado como um objeto Record. |
Valores EventStatusEnum
| Constante | Valor | Descrição |
|---|---|---|
| adStatusOK | 1 | A operação que disparou o evento foi bem sucedido |
| adStatusErrorsOccurred | 2 | A operação que disparou o evento com falha |
| adStatusCantDeny | 3 | Não é possível cancelar a operação pendente |
| adStatusCancel | 4 | Cancela a operação que disparou o evento |
| adStatusUnwantedEvent | 5 | Impede notificações subseqüentes antes que o método evento acabou executando |
<Completa Connection Object Reference