Поделиться через

Событие WillExecute (ADO)

  • Статья

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

Синтаксис

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

Параметры

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

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

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

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

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

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

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

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

Замечания

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

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

Примечание.

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

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

См. также

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