ADO WillExecute und ExecuteComplete Ereignisse
Definition und Verwendung
Das Ereignis ist ein automatisch aufgerufener Unterprogramm nach dem Eintreten eines bestimmten Vorgangs.
- Das WillExecute-Ereignis wird ausgelöst, bevor der Aufruf von objcomm.Execute, objconn.Execute oder objrs.Open erfolgt.
- Das ExecuteComplete-Ereignis wird ausgelöst, nachdem der Aufruf von objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery oder objrs.NextRecordset abgeschlossen wurde.
Syntax
WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn ExecuteComplete refaffected,objerror,status,objcomm,objrs,objconn
| Parameter | Beschreibung |
|---|---|
| src | Zeichenkette, die den Namen des SQL-Befehls oder der gespeicherten Prozedur enthält. |
| cursortyp | bestimmt den zu verwendenden Cursor-Typ.CursorTypeEnum Werte. |
| locktyp | bestimmt den zu verwendenden Lock-Typ.LockTypeEnum Werte. |
| options | ein oder mehrere CommandTypeEnum oder ExecuteOptionEnum Wert |
| reaffected | Long-Wert, die Anzahl der von diesem Befehl betroffenen Datensätze. |
| objerror |
Enthält das Error-Objekt mit den aufgetretenen Fehlern.
Anmerkung: Der Wert von EventStatusEnum muss auf adStatusErrorsOccurred gesetzt werden, um das Error-Objekt zu erstellen. |
| status | ein EventStatusEnum Wert. |
| objcomm |
Für WillExecute: Wenn dieses Ereignis von Command.Execute ausgelöst wird, bezieht sich der Parameter objcomm auf das Command-Objekt und der Parameter objrs wird auf Nothing gesetzt. Für ExecuteComplete: Das ausgeführte Command-Objekt. |
| objrs |
Für WillExecute: Wenn dieses Ereignis durch Recordset.Open verursacht wird, wird der Parameter objrs auf das Recordset-Objekt referenzieren und pCommand auf Nothing gesetzt. Für ExecuteComplete: Recordset-Objekt, ist das Ergebnis der Ausführung des Befehls. |
| objconn | Mit dem Connection-Objekt verbundene Objekte im Zusammenhang mit der Ausführung des Befehls. |
EventStatusEnum-Werte
| Konstante | Wert | Beschreibung |
|---|---|---|
| adStatusOK | 1 | Der Vorgang, der dieses Ereignis verursacht hat, war erfolgreich. |
| adStatusErrorsOccurred | 2 | Der Vorgang, der dieses Ereignis verursacht hat, ist fehlgeschlagen. |
| adStatusCantDeny | 3 | Die Aufhebung eines abgebrochenen Vorgangs ist nicht möglich. |
| adStatusCancel | 4 | Stornieren Sie die Aktion, die das Ereignis verursacht hat. |
| adStatusUnwantedEvent | 5 | Verhindern Sie vor dem Abschluss der Ausführung des Ereignismethods weitere Benachrichtigungen. |
