Evento WillExecute (ADO)

L'evento WillExecute viene chiamato appena prima che un comando in sospeso esegua una connessione.

Sintassi

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

Parametri

Origine
Stringa che contiene un comando SQL o un nome di stored procedure.

CursorType
CursorTypeEnum che contiene il tipo di cursore per l'oggetto Recordset che verrà aperto. Con questo parametro è possibile modificare il cursore in qualsiasi tipo durante un'operazioneRecordsetOpen Method (Recordset ADO). CursorType verrà ignorato per qualsiasi altra operazione.

LockType
Oggetto LockTypeEnum che contiene il tipo di blocco per l'oggetto Recordset che verrà aperto. Con questo parametro è possibile modificare il blocco in qualsiasi tipo durante un'operazione RecordsetOpen. LockType verrà ignorato per qualsiasi altra operazione.

Opzioni
Valore long che indica le opzioni che possono essere usate per eseguire il comando o aprire l'oggetto Recordset.

adStatus
Valore di stato EventStatusEnum che può essere adStatusCantDeny o adStatusOK quando questo evento viene chiamato. Se è adStatusCantDeny questo evento non può richiedere l'annullamento dell'operazione in sospeso.

pCommand
Oggetto Command (ADO) per il quale si applica questa notifica di evento.

pRecordset
Oggetto Recordset (ADO) per il quale si applica questa notifica di evento.

pConnection
Oggetto Connection (ADO) per il quale si applica questa notifica di evento.

Osservazioni

Un evento WillExecute può verificarsi a causa di una connessione. Metodo Execute (Connessione ADO), Metodo Execute (comando ADO) o Metodo Open (Recordset ADO) Il parametro pConnection deve sempre contenere un riferimento valido a un oggetto Connection. Se l'evento è dovuto a Connection.Execute, i parametri pRecordset e pCommand sono impostati su Nothing. Se l'evento è dovuto a Recordset.Open, il parametro pRecordset farà riferimento all'oggetto Recordset e il parametro pCommand è impostato su Nothing. Se l'evento è dovuto a Command.Execute, il parametro pCommand farà riferimento all'oggetto Command e il parametro pRecordset è impostato su Nothing.

WillExecute consente di esaminare e modificare i parametri di esecuzione in sospeso. Questo evento può restituire una richiesta di annullare il comando in sospeso.

Nota

Se l'origine di un Comando è un flusso specificato dalla Proprietà CommandStream Property (ADO), l'assegnazione di una nuova stringa al parametro WillExecuteSource modifica l'origine del Comando. La proprietà CommandStream verrà cancellata e la proprietà CommandText Property (ADO) verrà aggiornata con la nuova origine. Il flusso originale specificato da CommandStream verrà rilasciato e non sarà accessibile.

Se il dialetto della nuova stringa di origine differisce dall'impostazione originale della proprietà Dialect Property, corrispondente a CommandStream, è necessario specificare il dialetto corretto impostando la proprietà Dialect dell'oggetto command a cui fa riferimento pCommand.

Vedere anche

Esempio del modello di eventi ADO (VC++)
Riepilogo dei gestori eventi ADO
Oggetto Connection (ADO)