WillExecute-Ereignis (ADO)
Gilt für: Access 2013, Office 2013
Das WillExecute-Ereignis wird unmittelbar vor dem Ausführen eines ausstehenden Befehls für eine Verbindung aufgerufen.
Syntax
WillExecuteSource, CursorType, LockType, Options, adStatus, pCommand, pRecordset, pConnection
Parameter
| Parameter | Beschreibung |
|---|---|
| Source | Ein String -Wert, der einen SQL-Befehl oder den Namen einer gespeicherten Prozedur enthält. |
| CursorType | Ein CursorTypeEnum-Wert, der den Cursortyp für das Recordset -Objekt angibt, dass geöffnet wird. Mit diesem Parameter können Sie während eines Open-Vorgangs des Recordset -Objekts den Cursor in einen beliebigen Typ ändern. CursorType wird für alle anderen Vorgänge ignoriert. |
| LockType | Ein LockTypeEnum-Wert, der den Sperrtyp für das Recordset -Objekt enthält, das geöffnet wird. Mit diesem Parameter können Sie die Sperre während eines RecordsetOpen-Vorgangs in einen beliebigen Typ ändern. LockType wird für alle anderen Vorgänge ignoriert. |
| Optionen | Ein Long -Wert, der die Optionen angibt, die zum Ausführen des Befehls oder zum Öffnen des Recordset -Objekts verwendet werden können. |
| adStatus | EventStatusEnum. Legen Sie diesen Parameter vor Rückgabe des Ereignisses auf adStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern. Oder legen Sie ihn auf adStatusCancel fest, um den Abbruch des das Ereignis verursachenden Vorgangs anzufordern. |
| pCommand | Das Command-Objekt, für das diese Ereignisbenachrichtigung gilt. |
| pRecordset | Das Recordset-Objekt, für das diese Ereignisbenachrichtigung gilt. |
| pConnection | Das Connection-Objekt, für das diese Ereignisbenachrichtigung gilt. |
Hinweise
Ein WillExecute-Ereignis kann aufgrund einer Verbindung auftreten.Ausführen, Befehl.Execute oder Recordset.Open-Methode Der pConnection-Parameter 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 pRecordset-Parameter auf das Recordset-Objekt , und der pCommand-Parameter ist auf Nothing festgelegt. Wenn das Ereignis auf Command.Execute zurückzuführen ist, verweist der pCommand-Parameter auf das Command-Objekt , und der pRecordset-Parameter ist auf Nothing festgelegt.
Mit WillExecute können Sie die ausstehenden Ausführungsparameter untersuchen und ändern. Dieses Ereignis kann eine Anforderung zurückgeben, dass der ausstehende Befehl abgebrochen wird.