ADO WillExecute och ExecuteComplete-händelser

Definition och användning

Händelser är underprogram som automatiskt anropas efter att en specifik operation har inträffat.

  • WillExecute-händelsen utlöses innan objcomm.Execute, objconn.Execute eller objrs.Open anropas.
  • ExecuteComplete-händelsen utlöses efter att ha anropat objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery eller objrs.NextRecordset.

Syntax

WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn
ExecuteComplete reaffected,objerror,status,objcomm,objrs,objconn
Beskrivning
parametrar en sträng som innehåller SQL-kommandot eller namnet på en lagrad procedure.
cursortyp bestämmer den kursorotyp som ska användas.CursorTypeEnum värden之一.
locktyp bestämmer den låstyp som ska användas.LockTypeEnum värden之一.
options en eller flera CommandTypeEnum eller ExecuteOptionEnum Värde
reaffected Long-värde, antalet rader som påverkas av kommandot.
objerror Innehåller ett Error-objekt med inträffade fel.

Kommentar: EventStatusEnum-värdet måste sättas till adStatusErrorsOccurred för att skapa detta Error-objekt.

status en EventStatusEnum värde.
objcomm

För WillExecute: Om detta händelseobjekt utlösas av Command.Execute kommer objcomm-argumentet att referera till Command-objektet och objrs-argumentet kommer att sättas till Nothing.

För ExecuteComplete: Den körsamma Command-objektet.

objrs

För WillExecute: Om detta evenemang utlöses av Recordset.Open, kommer objrs-argumentet att referera till Recordset objektet, och pCommand-argumentet kommer att sättas till Nothing.

För ExecuteComplete: Recordset objekt, är resultatet av kommandoutförandet.

objconn Connection objekt som är associerat med kommandoutförande.

EventStatusEnum värden

Konstant Värde Beskrivning
adStatusOK 1 Åtgärden som orsakade händelsen lyckades.
adStatusErrorsOccurred 2 Åtgärden som orsakade händelsen misslyckades.
adStatusCantDeny 3 Det går inte att avbryta en väntande åtgärd.
adStatusCancel 4 Avbryt åtgärd som orsakade händelsen.
adStatusUnwantedEvent 5 Förbjud vidare meddelanden innan slutet av händelsemetoden.