Wydarzenia WillExecute i ExecuteComplete w ADO
Definicja i użycie
Wydarzenie to jest automatycznie wywoływane procedurą podprogramową po wystąpieniu konkretnej operacji.
- Wydarzenie WillExecute jest wywoływane przed wywołaniem objcomm.Execute, objconn.Execute lub objrs.Open.
- Wydarzenie ExecuteComplete jest wywoływane po zakończeniu wywołań objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery lub objrs.NextRecordset.
Gramatyka
WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn ExecuteComplete recaffected,objerror,status,objcomm,objrs,objconn
| parametr | Opis |
|---|---|
| src | ciąg znaków zawierający nazwę polecenia SQL lub procedury przechowalniczej. |
| cursortyp | określa typ kursora do użycia.CursorTypeEnum jeden z wartości. |
| locktyp | określa typ blokady do użycia.LockTypeEnum jeden z wartości. |
| opcje | jeden lub kilka CommandTypeEnum lub ExecuteOptionEnum Wartość |
| recaffected | Długość wartości, liczba rekordów wpływających na polecenie. |
| objerror |
Obiekt Error zawierający wystąpiłe błędy.
Komentarz: Wartość EventStatusEnum musi być ustawiona na adStatusErrorsOccurred, aby utworzyć ten obiekt Error. |
| status | jeden EventStatusEnum wartość. |
| objcomm |
Dla WillExecute: Jeśli to wydarzenie jest wywoływane przez Command.Execute, parametr objcomm odnosi się do obiektu Command, a parametr objrs jest ustawiany na Nothing. Dla ExecuteComplete: Wykonany obiekt Command. |
| objrs |
Dla WillExecute: Jeśli to zdarzenie jest wywoływane przez Recordset.Open, parametr objrs będzie odnosił się do obiektu Recordset, a parametr pCommand będzie ustawiony na Nothing. Dla ExecuteComplete: Obiekt Recordset, jest wynikiem wykonania polecenia. |
| objconn | Obiekt Connection związany z wykonywaniem polecenia. |
Wartości EventStatusEnum
| Stała | Wartość | Opis |
|---|---|---|
| adStatusOK | 1 | Operacja powodująca to zdarzenie się powiodła. |
| adStatusErrorsOccurred | 2 | Operacja powodująca to zdarzenie nie powiodła się. |
| adStatusCantDeny | 3 | Nie można anulować wstrzymanej operacji. |
| adStatusCancel | 4 | Anuluj operację powodującą zdarzenie. |
| adStatusUnwantedEvent | 5 | Zakazuj dalszych powiadomień przed zakończeniem wykonywania metody zdarzenia. |
