<Complete oggetto Connection di riferimento
Un evento è una subroutine che può essere chiamato automaticamente dopo il verificarsi di una determinata operazione.
- Il WillExecute evento può essere licenziato poco prima di una chiamata a objcomm.Execute, objconn.Execute o objrs.Open.
- ExecuteComplete evento può essere licenziato dopo una chiamata a objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery, o objrs.NextRecordset è completata.
Sintassi
WillExecute src,cursortyp,locktyp,options,
status,objcomm,objrs,objconn
ExecuteComplete recaffected,objerror,status,
objcomm,objrs,objconn
| Parametro | Descrizione |
|---|---|
| src | Una stringa che contiene un comando SQL o un nome di stored procedure |
| cursortyp | Specifica il tipo di cursore da utilizzare. Uno dei CursorTypeEnum valori |
| locktyp | Specifica il tipo di blocco da utilizzare. Uno dei LockTypeEnum valori |
| options | Uno o più dei CommandTypeEnum o ExecuteOptionEnum valori |
| recaffected | Il numero di record interessati dall'esecuzione |
| objerror | Un oggetto di errore che contiene gli errori che si sono verificati Note: Il valore EventStatusEnum deve essere impostato su adStatusErrorsOccurred per creare l'oggetto Errore |
| status | Un EventStatusEnum valore |
| objcomm | Per WillExecute : Impostare l'oggetto Command che è stato eseguito o per niente Per ExecuteComplete : L'oggetto Command che è stata eseguita |
| objrs | Per WillExecute : Impostare l'oggetto Recordset che ha portato dalla esecuzione del comando o per niente Per ExecuteComplete : L'oggetto Recordset che è il risultato del comando eseguito |
| objconn | L'oggetto di connessione associato con l'esecuzione del comando |
valori CursorTypeEnum
Specifica il tipo di cursore utilizzata in un oggetto Recordset.
| Costante | Valore | Descrizione |
|---|---|---|
| adOpenUnspecified | -1 | Non specificare il tipo di cursore. |
| adOpenForwardOnly | 0 | Predefinito. Utilizza un cursore forward-only. Identico a un cursore statico, tranne che si può solo scorrere in avanti i record. Questo migliora le prestazioni quando è necessario fare un solo passaggio attraverso un Recordset. |
| adOpenKeyset | 1 | Utilizza un cursore keyset. Come un cursore dinamico, salvo che non si può vedere i record che altri utenti aggiungono, anche se i record che altri utenti eliminano sono inaccessibili dal vostro Recordset. le modifiche dei dati da parte di altri utenti sono ancora visibili. |
| adOpenDynamic | 2 | Utilizza un cursore dinamico. Aggiunte, modifiche e cancellazioni da parte di altri utenti sono visibili, e tutti i tipi di movimento attraverso il Recordset sono ammessi, tranne che per i segnalibri, se il provider non li supporta. |
| adOpenStatic | 3 | Utilizza un cursore statico. Una copia statica di una serie di record che è possibile utilizzare per trovare i dati o generare report. Aggiunte, modifiche o cancellazioni da parte di altri utenti non sono visibili. |
valori LockTypeEnum
| Costante | Valore | Descrizione |
|---|---|---|
| adLockUnspecified | -1 | Non specificare un tipo di serratura. Per i cloni, il clone viene creato con lo stesso tipo di blocco come l'originale. |
| adLockReadOnly | 1 | Indica sola lettura record. Non è possibile modificare i dati. |
| adLockPessimistic | 2 | Indica il blocco pessimistico, record per record. Il provider fa ciò che è necessario per assicurare la modifica riuscita dei record, di solito bloccando record alla fonte dati immediatamente dopo la modifica. |
| adLockOptimistic | 3 | Indica blocco ottimistico, record per record. Il provider utilizza il blocco ottimistico, vincolando i record solo quando si chiama il metodo Update. |
| adLockBatchOptimistic | 4 | Indica aggiornamenti batch ottimistici. Richiesto per la modalità di aggiornamento batch. |
valori CommandTypeEnum
| Costante | Valore | Descrizione |
|---|---|---|
| adCmdUnspecified | -1 | Non specificare l'argomento tipo di comando. |
| adCmdText | 1 | Valuta CommandText come una definizione testuale di un comando o una chiamata di stored procedure. |
| adCmdTable | 2 | Valuta CommandText come nome tabella le cui colonne sono tutti restituiti da una query SQL generata internamente. |
| adCmdStoredProc | 4 | Valuta CommandText come un nome di stored procedure. |
| adCmdUnknown | 8 | Indica che il tipo di comando nella proprietà CommandText non è noto. |
| adCmdFile | 256 | Valuta CommandText come il nome del file di un Recordset memorizzati in modo persistente. Utilizzato solo con Recordset.Open o Requery. |
| adCmdTableDirect | 512 | Valuta CommandText come nome di una tabella le cui colonne sono tutti restituiti. Utilizzato solo con Recordset.Open o Requery. Per utilizzare il metodo Seek, il recordset deve essere aperto con adCmdTableDirect. Questo valore non può essere combinato con il valore di adAsyncExecute ExecuteOptionEnum. |
valori ExecuteOptionEnum
| Costante | Valore | Descrizione |
|---|---|---|
| adOptionUnspecified | -1 | Indica che il comando non è specificato. |
| adAsyncExecute | 16 | Indica che eseguire il comando in modo asincrono. Questo valore non può essere combinato con il valore adCmdTableDirect CommandTypeEnum. |
| adAsyncFetch | 32 | Indica che le righe rimanenti dopo la quantità iniziale specificato nella proprietà CacheSize devono essere recuperati in modo asincrono. |
| adAsyncFetchNonBlocking | 64 | Indica che il thread principale non blocchi durante il recupero. Se la riga richiesto non è stato recuperato, la riga corrente si sposta automaticamente alla fine del file. Se si apre un Recordset da un flusso contenente un Recordset memorizzati in modo persistente, adAsyncFetchNonBlocking non avrà un effetto; l'operazione sarà sincrona e blocco. adAsynchFetchNonBlocking non ha alcun effetto quando l'opzione adCmdTableDirect viene utilizzato per aprire il Recordset. |
| adExecuteNoRecords | 128 | Indica che il testo comando è un comando o stored procedure che non restituisce righe (for example, a command that only inserts data) . Se tutte le righe vengono recuperate, vengono scartati e non restituiti. adExecuteNoRecords può essere passato solo come un parametro opzionale per il comando o il collegamento metodo Execute. |
| adExecuteStream | 256 | Indica che i risultati di un esecuzione dei comandi devono essere restituiti come un flusso. adExecuteStream può essere passato solo come un parametro opzionale per il comando metodo Execute. |
| adExecuteRecord | 512 | Indica che il CommandText è un comando o una stored procedure che restituisce una singola riga che deve essere restituito come un oggetto record. |
valori EventStatusEnum
| Costante | Valore | Descrizione |
|---|---|---|
| adStatusOK | 1 | L'operazione che ha generato l'evento ha avuto successo |
| adStatusErrorsOccurred | 2 | L'operazione che ha generato l'evento non è riuscita |
| adStatusCantDeny | 3 | Impossibile annullare l'operazione in sospeso |
| adStatusCancel | 4 | Annulla l'operazione che ha attivato l'evento |
| adStatusUnwantedEvent | 5 | Impedisce notifiche successive prima del metodo evento ha terminato l'esecuzione |
<Complete oggetto Connection di riferimento