WillExecute 이벤트(ADO)

  • 아티클

WillExecute 이벤트는 보류 중인 명령이 연결에서 실행되기 직전에 호출됩니다.

구문

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

매개 변수

원본
SQL 명령 또는 저장 프로시저 이름이 포함된 문자열 입니다.

CursorType
열 레코드 집합의 커서 유형이 들어 있는 CursorTypeEnum입니다. 이 매개 변수를 사용하면 RecordsetOpen 메서드(ADO 레코드 집합) 작업 중에 커서를 임의의 형식으로 변경할 수 있습니다. CursorType은 다른 모든 작업에서 무시됩니다.

LockType
열 레코드 집합의 잠금 유형이 포함된 LockTypeEnum입니다. 이 매개 변수를 사용하면 RecordsetOpen 작업 중에 잠금을 임의의 유형으로 변경할 수 있습니다. LockType은 다른 모든 작업에서 무시됩니다.

옵션
명령을 실행하거나 레코드 집합을 여는 데 사용할 수 있는 옵션을 나타내는 Long 값입니다.

adStatus
이 이벤트가 호출될 때의 EventStatusEnum 상태 값으로, adStatusCantDeny 또는 adStatusOK일 수 있습니다. adStatusCantDeny인 경우 이 이벤트가 보류 중인 작업의 취소를 요청하지 않을 수 있습니다.

pCommand
이 이벤트 알림이 적용되는 Command 개체(ADO) 개체입니다.

pRecordset
이 이벤트 알림이 적용되는 Recordset 개체(ADO) 개체입니다.

pConnection
이 이벤트 알림이 적용되는 Connection 개체(ADO) 개체입니다.

설명

연결로 인해 WillExecute 이벤트가 발생할 수 있습니다. Execute 메서드(ADO 연결), Execute 메서드(ADO 명령) 또는 Open 메서드(ADO 레코드 집합)pConnection 매개 변수는 항상 Connection 개체에 대한 유효한 참조를 포함해야 합니다. 이벤트가 Connection.Execute로 인해 발생하는 경우 pRecordset 및 pCommand 매개 변수는 Nothing으로 설정됩니다. 이벤트가 Recordset.Open으로 인해 발생하는 경우 pRecordset 매개 변수는 Recordset 개체를 참조하고 pCommand 매개 변수는 Nothing으로 설정됩니다. 이벤트가 Command.Execute로 인해 발생하는 경우 pCommand 매개 변수는 Command 개체를 참조하고 pRecordset 매개 변수는 Nothing으로 설정됩니다.

WillExecute를 사용하면 보류 중인 실행 매개 변수를 검사하고 수정할 수 있습니다. 이 이벤트는 보류 중인 명령을 취소하는 요청을 반환할 수 있습니다.

참고

Command의 원래 원본이 CommandStream 속성(ADO)으로 지정된 스트림인 경우 새 문자열을 WillExecuteSource 매개 변수에 할당하면 Command의 원본이 변경됩니다. CommandStream 속성이 삭제되고 CommandText 속성(ADO)이 새 원본으로 업데이트됩니다. CommandStream으로 지정된 원래 스트림이 해제되고 액세스할 수 없게 됩니다.

새 원본 문자열의 언어가 Dialect 속성의 원래 설정(CommandStream에 해당함)과 다른 경우 pCommand에서 참조하는 명령 개체의 Dialect 속성을 설정하여 올바른 언어를 지정해야 합니다.

참고 항목

ADO 이벤트 모델 예제(VC++)
ADO 이벤트 처리기 요약
연결 개체(ADO)