WillExecute-Ereignis (ADO)

  • Artikel

Das WillExecute-Ereignis wird direkt vor der Ausführung eines ausstehenden Befehls für eine Verbindung aufgerufen.

Syntax

  
WillExecute Source, CursorType, LockType, Options, adStatus, pCommand, pRecordset, pConnection

Parameter

Quelle
Eine Zeichenfolge, die den Namen eines SQL-Befehls oder einer gespeicherten Prozedur enthält.

CursorType
Eine CursorTypeEnum, die den Cursortyp für das Recordset enthält, das geöffnet wird. Mit diesem Parameter können Sie den Cursor während eines Vorgangs mit der RecordsetOpen-Methode (ADO-Recordset) in einen beliebigen Typ ändern. Für alle anderen Vorgänge wird CursorType ignoriert.

LockType
Eine LockTypeEnum, die den Sperrentyp für das Recordset enthält, das geöffnet wird. Mit diesem Parameter können Sie die Sperre während eines RecordsetOpen-Vorgangs in einen beliebigen Typ ändern. Für alle anderen Vorgänge wird LockType ignoriert.

Optionen
Ein Long-Wert, der Optionen angibt, die verwendet werden können, um den Befehl auszuführen oder das Recordset zu öffnen.

adStatus
Ein EventStatusEnum-Statuswert, der adStatusCantDeny oder adStatusOK lauten kann, wenn dieses Ereignis aufgerufen wird. Beim Statuswert adStatusCantDeny kann dieses Ereignis den Abbruch des ausstehenden Vorgangs nicht anfordern.

pCommand
Das Command-Objekt (ADO), für das diese Ereignisbenachrichtigung gilt.

pRecordset
Das Recordset-Objekt (ADO), für das diese Ereignisbenachrichtigung gilt.

pConnection
Das Connection-Objekt (ADO), für das diese Ereignisbenachrichtigung gilt.

Bemerkungen

Ein WillExecute-Ereignis kann aufgrund einer Connection. Execute-Methode (ADO-Verbindung), Execute-Methode (ADO-Befehl) oder Open-Methode (ADO-Recordset) auftreten. Der Parameter pConnection sollte immer einen gültigen Verweis auf ein Connection-Objekt enthalten. Wenn das Ereignis auf Connection.Execute zurückzuführen ist, werden die Parameter pRecordset und pCommand auf Nothing festgelegt. Wenn das Ereignis auf Recordset.Open zurückzuführen ist, verweist der Parameter pRecordset auf das Recordset-Objekt, und der Parameter pCommand wird auf Nothing festgelegt. Wenn das Ereignis auf Command.Open zurückzuführen ist, verweist der Parameter pCommand auf das Command-Objekt, und der Parameter pRecordset wird auf Nothing festgelegt.

WillExecute ermöglicht es Ihnen, die Parameter einer ausstehenden Ausführung zu untersuchen und zu ändern. Dieses Ereignis kann eine Anforderung zum Abbrechen des ausstehenden Befehls zurückgeben.

Hinweis

Wenn die ursprüngliche Quelle für ein Command-Objekt ein Datenstrom ist, der von der CommandStream-Eigenschaft (ADO) angegeben wird, wird durch Zuweisen einer neuen Zeichenfolge zum Parameter WillExecuteSource die Quelle des Command-Objekts geändert. Die CommandStream-Eigenschaft wird gelöscht, und die CommandText-Eigenschaft (ADO) wird mit der neuen Quelle aktualisiert. Der von CommandStream angegebene ursprüngliche Datenstrom wird freigegeben, und der Zugriff auf ihn ist nicht möglich.

Unterscheidet sich der Dialekt der neuen Quellzeichenfolge von der ursprünglichen Einstellung der Dialect-Eigenschaft (die CommandStream entsprach), muss der richtige Dialekt angegeben werden, indem die Dialect-Eigenschaft des Command-Objekts festgelegt wird, auf das pCommand verweist.

Weitere Informationen

ADO-Ereignismodell – Beispiel (VC++)
ADO-Ereignishandler – Übersicht
Connection-Objekt (ADO)