Execute 메서드(ADO 명령)

Command 개체의 CommandText 또는 CommandStream 속성에 지정된 쿼리, SQL 문 또는 저장 프로시저를 실행합니다.

구문

  
Set recordset = command.Execute( RecordsAffected, Parameters, Options )  

Return Value

Recordset 개체 참조, 스트림 또는 Nothing을 반환합니다.

매개 변수

RecordsAffected
(선택 사항) 공급자가 작업이 영향을 준 레코드 수를 반환하는 Long 변수입니다. RecordsAffected 매개 변수는 작업 쿼리 또는 저장 프로시저에만 적용됩니다. RecordsAffected는 결과 반환 쿼리 또는 저장 프로시저에서 반환되는 레코드 수를 반환하지 않습니다. 이 정보를 얻으려면 RecordCount 속성을 사용하세요. Execute 메서드는 adAsyncExecute와 함께 사용하면 올바른 정보를 반환하지 않습니다. 명령이 비동기적으로 실행될 때 해당 메서드가 반환될 때 영향을 받는 레코드 수를 아직 알 수 없기 때문입니다.

매개 변수
(선택 사항) CommandText 또는 CommandStream에 지정된 입력 문자열 또는 스트림과 함께 사용되는 매개 변수 값의 변형 배열입니다. (출력 매개 변수는 이 인수에서 전달되면 올바른 값을 반환하지 않습니다.)

옵션
(선택 사항) 공급자가 Command 개체의 CommandText 또는 CommandStream 속성을 평가해야 하는 방법을 나타내는 Long 값입니다. CommandTypeEnum 및/또는 ExecuteOptionEnum 값을 사용하여 만든 비트 마스크 값일 수 있습니다. 예를 들어 ADO가 CommandText 속성의 값을 텍스트로 평가하도록 하고 명령이 명령 텍스트가 실행될 때 생성될 수 있는 레코드를 삭제하고 반환하지 않아야 함을 나타내려면 adCmdText 및 adExecuteNoRecords를 함께 사용할 수 있습니다.

참고

ExecuteOptionEnum 값 adExecuteNoRecords를 사용하면 내부 처리를 최소화하여 성능을 향상시킬 수 있습니다. adExecuteStream을 지정한 경우 adAsyncFetch 및 adAsynchFetchNonBlocking 옵션은 무시됩니다. adCmdFile 또는 adCmdTableDirect의 CommandTypeEnum 값을 Execute와 함께 사용하지 마세요. 이러한 값은 Recordset의 Open 및 Requery 메서드의 옵션으로만 사용할 수 있습니다.

설명

Command 개체에서 Execute 메서드를 사용하면 개체의 CommandText 속성 또는 CommandStream 속성에 지정된 쿼리가 실행됩니다.

결과는 레코드 집합(기본값) 또는 이진 정보 스트림으로 반환됩니다. 이진 스트림을 얻으려면 Options에서 adExecuteStream을 지정한 다음 Command.Properties("Output Stream")를 설정하여 스트림을 제공합니다. ADO Stream 개체를 지정하여 결과를 수신하거나 IIS Response 개체와 같은 다른 스트림 개체를 지정할 수 있습니다. adExecuteStream을 사용하여 Execute를 호출하기 전에 스트림을 지정하지 않은 경우 오류가 발생합니다. Execute에서 반환되는 스트림의 위치는 공급자별로 다릅니다.

결과를 반환하기 위한 명령이 아닌 경우(예: SQL UPDATE 쿼리) 공급자는 adExecuteNoRecords 옵션이 지정된 경우 Nothing을 반환합니다. 그렇지 않은 경우 Execute는 닫혀 있는 레코드 집합을 반환합니다. 일부 애플리케이션 언어에서는 레코드 집합이 필요하지 않은 경우 이 반환 값을 무시할 수 있습니다.

CommandType이 adCmdStoredProc, adCmdTable 또는 adCmdTableDirect일 때 사용자가 CommandStream에 대한 값을 지정하면 Execute에서 오류가 발생합니다.

쿼리에 매개 변수가 있는 경우 Execute 호출과 함께 전달된 매개 변수 값으로 재정의하지 않는 한 Command 개체의 매개 변수에 대한 현재 값이 사용됩니다. Execute 메서드를 호출할 때 일부 매개 변수에 대한 새 값을 생략하여 매개 변수의 하위 집합을 재정의할 수 있습니다. 매개 변수를 지정하는 순서는 메서드가 매개 변수를 전달하는 순서와 동일합니다. 예를 들어 네 개(이상)의 매개 변수가 있고 첫 번째 및 네 번째 매개 변수에 대해서만 새 값을 전달하려는 경우 Parameters 인수로 Array(var1,,,var4)를 전달합니다.

참고

출력 매개 변수는 Parameters 인수에서 전달되면 올바른 값을 반환하지 않습니다.

이 작업이 종료될 때 ExecuteComplete 이벤트가 실행됩니다.

참고

URL이 포함된 명령을 실행할 때 http 체계를 사용하는 URL은 Microsoft OLE DB Provider for Internet Publishing을 자동으로 호출합니다. 자세한 내용은 절대 URL 및 상대 URL을 참조하세요.

적용 대상

명령 개체(ADO)

참고 항목

Execute, Requery, Clear 메서드 예제(VB)
Execute, Requery, Clear 메서드 예제(VBScript)
Execute, Requery, Clear 메서드 예제(VC++)
CommandStream 속성(ADO)
CommandText 속성(ADO)
CommandTypeEnum
Execute 메서드(ADO 연결)
ExecuteComplete 이벤트(ADO)