<Complet de referință obiect de conexiune
Un eveniment este o subrutină, care poate fi numit automat după a avut loc o operațiune specifică.
- WillExecute eveniment poate fi concediat chiar înainte de un apel la objcomm.Execute, objconn.Execute sau objrs.Open.
- ExecuteComplete eveniment poate fi tras după un apel la objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery sau objrs.NextRecordset este finalizată.
Sintaxă
WillExecute src,cursortyp,locktyp,options,
status,objcomm,objrs,objconn
ExecuteComplete recaffected,objerror,status,
objcomm,objrs,objconn
| Parametru | Descriere |
|---|---|
| src | Un șir care conține o comandă SQL sau un nume de procedură stocată |
| cursortyp | Specifică tipul de cursor care urmează să fie utilizat. Unul dintre CursorTypeEnum valorilor |
| locktyp | Specifică tipul de blocare care urmează să fie utilizat. Unul dintre LockTypeEnum valorilor |
| options | Unul sau mai multe dintre CommandTypeEnum sau ExecuteOptionEnum valorilor |
| recaffected | Numărul de înregistrări afectate de executarea |
| objerror | Un obiect de eroare care conține erorile apărute Note: Valoarea EventStatusEnum trebuie setată la adStatusErrorsOccurred pentru a crea obiectul de eroare |
| status | O EventStatusEnum valoare |
| objcomm | Pentru WillExecute : Setați la obiectul de comandă , care a fost executat sau nimic Pentru ExecuteComplete : Obiectul comandă care a fost executat |
| objrs | Pentru WillExecute : Setați obiectul Recordset care a rezultat din executarea comenzii sau la nimic Pentru ExecuteComplete : Obiectul Recordset care este rezultatul comenzii executate |
| objconn | Obiectul Connection, care este asociat cu executarea comenzii |
Valorile CursorTypeEnum
Specifică tipul de cursor utilizat într-un obiect Recordset.
| Constant | Valoare | Descriere |
|---|---|---|
| adOpenUnspecified | -1 | nu specifică tipul de cursor. |
| adOpenForwardOnly | 0 | Mod implicit. Folosește un cursor numai înainte. Identic cu un cursor static, cu excepția faptului că puteți derula înainte numai prin înregistrări. Acest lucru îmbunătățește performanța atunci când aveți nevoie pentru a face doar o singură trecere printr-un Recordset. |
| adOpenKeyset | 1 | Folosește un cursor keyset. Ca un cursor dinamic, cu excepția faptului că nu puteți vedea înregistrările pe care alți utilizatori adaugă, cu toate că înregistrările care alți utilizatori șterg sunt inaccesibile din Recordset dumneavoastră. Modificări date de către alți utilizatori sunt încă vizibile. |
| adOpenDynamic | 2 | Folosește un cursor dinamic. Adăugări, modificări și ștergeri de către alți utilizatori sunt vizibile, și sunt permise toate tipurile de circulație prin Recordset, cu excepția semne de carte, în cazul în care furnizorul nu le susține. |
| adOpenStatic | 3 | Folosește un cursor static. O copie statică a unui set de înregistrări pe care le puteți utiliza pentru a găsi date sau de a genera rapoarte. Adăugări, modificări sau eliminări ale altor utilizatori nu sunt vizibile. |
Valorile LockTypeEnum
| Constant | Valoare | Descriere |
|---|---|---|
| adLockUnspecified | -1 | nu specifică un tip de blocare. Pentru clone, clona este creat cu același tip de blocare ca și originalul. |
| adLockReadOnly | 1 | Indică read-only înregistrări. Nu puteți modifica datele. |
| adLockPessimistic | 2 | Indică blocare pesimistă, înregistrare cu înregistrare. Furnizorul face ceea ce este necesar pentru a asigura editarea cu succes a înregistrărilor, de obicei, prin blocarea înregistrărilor de la sursa de date imediat după editare. |
| adLockOptimistic | 3 | Indică blocare optimist, înregistrare cu înregistrare. Furnizorul utilizează blocare optimistă, blocarea înregistrărilor numai atunci când apelați metoda de actualizare. |
| adLockBatchOptimistic | 4 | Indică actualizări lot optimiste. Necesar pentru modul de actualizare lot. |
Valorile CommandTypeEnum
| Constant | Valoare | Descriere |
|---|---|---|
| adCmdUnspecified | -1 | nu specifică argumentul tip de comandă. |
| adCmdText | 1 | Estimează CommandText ca o definiție textuală a unei comenzi sau stocate procedură de apel. |
| adCmdTable | 2 | Estimează CommandText ca un nume de tabel ale cărui coloane sunt toate returnate de o interogare SQL generat intern. |
| adCmdStoredProc | 4 | Estimează CommandText ca nume de procedură stocată. |
| adCmdUnknown | 8 | Indică faptul că tipul de comandă în proprietatea CommandText nu este cunoscută. |
| adCmdFile | 256 | Estimează CommandText ca nume de fișier al unui Recordset stocat persistent. Folosit cu Recordset.Open sau reinterogare numai. |
| adCmdTableDirect | 512 | Estimează CommandText ca un nume de tabel ale cărui coloane sunt toate returnate. Folosit cu Recordset.Open sau reinterogare numai. Pentru a utiliza metoda Seek, The Recordset trebuie să fie deschis cu adCmdTableDirect. Această valoare nu poate fi combinat cu adAsyncExecute valoarea ExecuteOptionEnum. |
Valorile ExecuteOptionEnum
| Constant | Valoare | Descriere |
|---|---|---|
| adOptionUnspecified | -1 | Indică faptul că comanda este nespecificat. |
| adAsyncExecute | 16 | Indică faptul că comanda ar trebui să execute asincronă. Această valoare nu poate fi combinat cu valoarea adCmdTableDirect CommandTypeEnum. |
| adAsyncFetch | 32 | Indică faptul că rândurile rămase după cantitatea inițială specificată în proprietatea Cachesize ar trebui să fie recuperate asincronă. |
| adAsyncFetchNonBlocking | 64 | Indică faptul că firul principal nu blochează în timp ce recuperarea. În cazul în care linia solicitată nu a fost preluat, rândul curent se mută automat la sfârșitul fișierului. Dacă deschideți un Recordset dintr-un flux care conține un Recordset stocate persistent, adAsyncFetchNonBlocking nu va avea un efect; operațiunea va fi sincron și de blocare. adAsynchFetchNonBlocking nu are nici un efect în cazul în care opțiunea adCmdTableDirect este utilizată pentru a deschide Recordset. |
| adExecuteNoRecords | 128 | Indică faptul că textul de comandă este o comandă sau o procedură stocată care nu returnează rânduri (for example, a command that only inserts data) . În cazul în care orice rânduri sunt recuperate, ele sunt eliminate și nu a revenit. adExecuteNoRecords poate fi transmis doar ca un parametru opțional la comandă sau metoda de conectare Executare. |
| adExecuteStream | 256 | Indică faptul că rezultatele unei comenzi de execuție ar trebui să fie returnate ca un flux. adExecuteStream poate fi transmis doar ca un parametru opțional la comandă metoda Execute. |
| adExecuteRecord | 512 | Indică faptul că CommandText este o comandă sau o procedură stocată care returnează un singur rând, care ar trebui să fie returnate ca un obiect Record. |
Valorile EventStatusEnum
| Constant | Valoare | Descriere |
|---|---|---|
| adStatusOK | 1 | Operațiunea care a tras evenimentul a avut succes |
| adStatusErrorsOccurred | 2 | Operațiunea care a tras evenimentul nu a reușit |
| adStatusCantDeny | 3 | Nu se poate anula operația de așteptare |
| adStatusCancel | 4 | Revocă operația pe care a tras evenimentul |
| adStatusUnwantedEvent | 5 | Previne notificările ulterioare înainte de metoda de eveniment a terminat de executare |
<Complet de referință obiect de conexiune