WillExecute-Ereignis (ADO)

Das WillExecute-Ereignis wird aufgerufen, bevor ein ausstehender Befehl für eine Verbindung ausgeführt wird.

Syntax

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

Parameter

Source-
Eine Zeichenfolge, die einen SQL-Befehl oder einen Namen einer gespeicherten Prozedur enthält.

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

LockType-
Eine LockTypeEnum-, die den Sperrtyp 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. LockType- wird für jeden anderen Vorgang ignoriert.

Optionen
Ein Long-Wert, der Optionen angibt, mit denen der Befehl ausgeführt werden kann, oder das Recordsetgeöffnet werden kann.

adStatus-
Ein EventStatusEnum Statuswert, der adStatusCantDeny oder adStatusOK- sein kann, wenn dieses Ereignis aufgerufen wird. Wenn es adStatusCantDenyist, fordert dieses Ereignis möglicherweise keinen Abbruch des ausstehenden Vorgangs an.

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

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

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

Bemerkungen

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

WillExecute ermöglicht es Ihnen, die ausstehenden Ausführungsparameter zu untersuchen und zu ändern. Dieses Ereignis kann eine Anforderung zurückgeben, dass der ausstehende Befehl abgebrochen wird.

Anmerkung

Wenn die ursprüngliche Quelle für eine Command ein stream ist, der durch die CommandStream Property (ADO)-Eigenschaft angegeben wird, ändert das Zuweisen einer neuen Zeichenfolge zur WillExecuteSource Parameter die Quelle der Command. Die CommandStream-eigenschaft wird gelöscht, und die CommandText-Eigenschaft (ADO)-Eigenschaft wird mit der neuen Quelle aktualisiert. Der ursprüngliche Stream, der von CommandStream- angegeben wird, wird freigegeben und kann nicht aufgerufen werden.

Wenn sich der Dialekt der neuen Quellzeichenfolge von der ursprünglichen Einstellung der Dialekteigenschaft -Eigenschaft unterscheidet (die dem CommandStream-entspricht), muss der richtige Dialekt angegeben werden, indem die Dialekt--Eigenschaft des Befehlsobjekts festgelegt wird, auf das von pCommandverwiesen wird.

Siehe auch

ADO-Ereignismodell (Beispiel) (VC++)
ADO-Ereignishandlerzusammenfassung
Connection-Objekt (ADO)