Execute 方法 (ADO 命令)

执行 Command 对象的CommandTextCommandStream 属性中指定的查询、SQL 语句或存储过程。

语法

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

返回值

返回 Recordset 对象引用、流或 Nothing

参数

RecordsAffected
可选。 一个 Long 变量,提供程序将返回操作受影响的记录数。 RecordsAffected 参数仅适用于作查询或存储过程。 RecordsAffected 不返回结果返回查询或存储过程返回的记录数。 若要获取此信息,请使用 RecordCount 属性。 Execute 方法在与 adAsyncExecute 一起使用时不会返回正确的信息,只是因为当异步执行命令时,受影响的记录数在方法返回时可能还未知。

参数
可选。 与 CommandTextCommandStream 中指定的输入字符串或流一起使用的参数值的变量数组。 (输出参数在传入此参数时不会返回正确的值。

选项
可选。 一个 Long 值,指示提供程序应如何评估 CommandTextCommandStream 对象的 CommandStream 属性。 可以是使用 CommandTypeEnum 和/或 ExecuteOptionEnum 值进行的位掩码值。 例如,如果要让 ADO 将 CommandText 属性的值评估为文本,则可以结合使用 adCmdText 和adExecuteNoRecords,并指示该命令应放弃,并且不返回在命令文本执行时可能生成的任何记录。

注释

使用 ExecuteOptionEnumadExecuteNoRecords 通过最小化内部处理来提高性能。 如果指定 了 adExecuteStream ,则忽略 adAsyncFetchadAsynchFetchNonBlocking 选项。 请勿将 adCmdFileadCmdTableDirectCommandTypeEnum 值与 Execute 配合使用。 这些值只能用作 OpenRequeryRecordset方法的选项。

注解

Command 对象使用 Execute 方法执行在对象的 CommandText 属性或 CommandStream 属性中指定的查询。

结果以 Recordset (默认情况下)或二进制信息流的形式返回。 若要获取二进制流,请在 Options 中指定 adExecuteStream,然后通过设置 Command.Properties(“Output Stream”)提供流。 可以指定 ADO Stream 对象来接收结果,也可以指定另一个流对象,例如 IIS 响应对象。 如果在使用 adExecuteStream 调用 Execute 之前未指定流,则会发生错误。 从 Execute 返回时流的位置特定于提供程序。

如果命令不打算返回结果(例如,SQL UPDATE 查询),只要指定了 adExecuteNoRecords ,提供程序将返回 Nothing;否则,Execute 返回已关闭的 Recordset。 如果不需要 Recordset ,某些应用程序语言允许忽略此返回值。

如果用户在 CommandTypeadCmdStoredProc、adCmdTableadCmdTableDirect 时为 CommandStream 指定值,则执行将引发错误。

如果查询具有参数,则使用 Command 对象的参数的当前值,除非使用 通过 Execute 调用传递的参数值重写这些值。 调用 Execute 方法时,可以通过省略某些参数的新值来替代参数的子集。 指定参数的顺序与方法传递参数的顺序相同。 例如,如果存在四个(或更多)参数,并且想要仅传递第一个和第四个参数的新值,则作为 Parameters 参数传递Array(var1,,,var4)

注释

输出参数在参数中传递时不会返回正确的值。

此作结束时将发出 ExecuteComplete 事件。

注释

发出包含 URL 的命令时,使用 http 方案的命令将自动调用 Microsoft OLE DB Provider for Internet Publishing。 有关详细信息,请参阅 绝对 URL 和相对 URL

应用到

Command 对象 (ADO)

另请参阅

Execute、Requery 和 Clear 方法示例 (VB)
Execute、Requery 和 Clear 方法示例 (VBScript)
Execute、Requery 和 Clear 方法示例(VC++)
CommandStream 属性 (ADO)
CommandText 属性 (ADO)
CommandTypeEnum
Execute 方法(ADO 连接)
ExecuteComplete 事件 (ADO)