ADO WillExecute en ExecuteComplete evenementen
Definitie en gebruik
Evenementen zijn subroutines die automatisch worden aangeroepen na het uitvoeren van een specifieke actie.
- Het WillExecute-evenement wordt geactiveerd voordat objcomm.Execute, objconn.Execute of objrs.Open worden aangeroepen.
- Het ExecuteComplete-evenement wordt geactiveerd na het voltooien van de aanroepen van objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery of objrs.NextRecordset.
Syntaxis
WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn ExecuteComplete recaffected,objerror,status,objcomm,objrs,objconn
parameter | Beschrijving |
---|---|
src | Een string die de naam van het SQL-commando of de naam van de opgeslagen procedure bevat. |
cursortyp | specificeert het te gebruiken type cursor.CursorTypeEnum waarden. |
locktyp | specificeert het te gebruiken type lock.LockTypeEnum waarden. |
options | één of meerdere CommandTypeEnum of ExecuteOptionEnum Waarde |
recaffected | Een Long-waarde die het aantal records aangeeft dat het commando beïnvloedt. |
objerror |
Bevat een Error object met de fouten die zijn opgetreden.
Opmerking: de waarde van EventStatusEnum moet worden ingesteld op adStatusErrorsOccurred om het Error object te creëren. |
status | een EventStatusEnum waarde. |
objcomm |
Voor WillExecute: als dit evenement wordt geactiveerd door Command.Execute, verwijst objcomm naar het Command object en wordt objrs ingesteld op Nothing. Voor ExecuteComplete: het uitgevoerde Command object. |
objrs |
Voor WillExecute: Als dit event wordt geactiveerd door Recordset.Open, zal de objrs parameter het Recordset Object refereren, en het pCommand parameter wordt Nothing ingesteld. Voor ExecuteComplete: Recordset Object, is het resultaat van de uitvoering van de opdracht. |
objconn | De Connection Object geassocieerd met de uitvoering van de opdracht. |
EventStatusEnum Waarden
Constant | Waarde | Beschrijving |
---|---|---|
adStatusOK | 1 | De actie die dit event veroorzaakte, is geslaagd. |
adStatusErrorsOccurred | 2 | De actie die dit event veroorzaakte, is mislukt. |
adStatusCantDeny | 3 | Kan de wachtende actie niet annuleren. |
adStatusCancel | 4 | Annuleer de actie die het event veroorzaakte. |
adStatusUnwantedEvent | 5 | Verbied voorafgaande meldingen voordat de uitvoering van het eventueel method is voltooid. |