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.