Событие WillExecute (ADO)

Событие WillExecute вызывается непосредственно перед выполнением ожидающей команды в соединении.

Синтаксис

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

Параметры

Источник
Строка, содержащая команду SQL или имя хранимой процедуры.

CursorType
CursorTypeEnum, содержащий тип курсора для открываемого набора записей. С помощью этого параметра можно изменить курсор на любой тип во время операции открытия метода Recordset(ADO Recordset). CursorType будет игнорироваться для любой другой операции.

LockType
Объект LockTypeEnum, содержащий тип блокировки для открываемого набора записей. С помощью этого параметра можно изменить блокировку на любой тип во время операции RecordsetOpen . Параметр LockType будет игнорироваться для любой другой операции.

Параметры
Значение Типа Long , указывающее параметры, которые можно использовать для выполнения команды или открытия набора записей.

adStatus
Значение состояния EventStatusEnum , которое может иметь значение adStatusCantDeny или adStatusOK при вызове этого события. Если это adStatusCantDeny, это событие может не запрашивать отмену ожидающей операции.

pCommand
Объект Command Object (ADO ), к которому применяется это уведомление о событии.

pRecordset
Объект Recordset Object (ADO ), к которому применяется это уведомление о событии.

pConnection
Объект Connection Object (ADO ), к которому применяется это уведомление о событии.

Комментарии

Событие WillExecute может произойти из-за подключения. Метод Execute (соединение ADO),метод Execute (команда ADO) или Метод Open (ADO Recordset) Параметр pConnection всегда должен содержать допустимую ссылку на объект Connection . Если событие связано с Connection.Execute, параметры pRecordset и pCommand имеют значение Nothing. Если событие связано с Recordset.Open, параметр pRecordset будет ссылаться на объект Recordset , а параметру pCommand присваивается значение Nothing. Если событие связано с Command.Execute, параметр pCommand будет ссылаться на объект Command , а параметр pRecordset имеет значение Nothing.

WillExecute позволяет изучить и изменить ожидающие параметры выполнения. Это событие может вернуть запрос на отмену ожидающей команды.

Примечание

Если исходным источником для Command является поток, заданный свойством CommandStream Property (ADO), при назначении новой строки параметру WillExecuteSource изменяется источник command. Свойство CommandStream будет очищено, а свойство CommandText Property (ADO) будет обновлено с учетом нового источника. Исходный поток, указанный в CommandStream , будет освобожден и не будетдоступ.

Если диалект новой исходной строки отличается от исходного параметра свойства Диалект (соответствующего CommandStream), правильный диалект необходимо указать, задав свойство Диалект командного объекта, на который ссылается pCommand.

См. также:

Пример модели событий ADO (Visual C ++)
Общие сведения об обработчике событий ADO
Объект Connection (ADO)