执行 Command 对象的CommandText 或 CommandStream 属性中指定的查询、SQL 语句或存储过程。
语法
Set recordset = command.Execute( RecordsAffected, Parameters, Options )
返回值
返回 Recordset 对象引用、流或 Nothing。
参数
RecordsAffected
可选。 一个 Long 变量,提供程序将返回操作受影响的记录数。
RecordsAffected 参数仅适用于作查询或存储过程。
RecordsAffected 不返回结果返回查询或存储过程返回的记录数。 若要获取此信息,请使用 RecordCount 属性。
Execute 方法在与 adAsyncExecute 一起使用时不会返回正确的信息,只是因为当异步执行命令时,受影响的记录数在方法返回时可能还未知。
参数
可选。 与 CommandText 或 CommandStream 中指定的输入字符串或流一起使用的参数值的变量数组。 (输出参数在传入此参数时不会返回正确的值。
选项
可选。 一个 Long 值,指示提供程序应如何评估 CommandText 或 CommandStream 对象的 CommandStream 属性。 可以是使用 CommandTypeEnum 和/或 ExecuteOptionEnum 值进行的位掩码值。 例如,如果要让 ADO 将 CommandText 属性的值评估为文本,则可以结合使用 adCmdText 和adExecuteNoRecords,并指示该命令应放弃,并且不返回在命令文本执行时可能生成的任何记录。
注释
使用 ExecuteOptionEnum 值 adExecuteNoRecords 通过最小化内部处理来提高性能。 如果指定 了 adExecuteStream ,则忽略 adAsyncFetch 和 adAsynchFetchNonBlocking 选项。 请勿将 adCmdFile 或 adCmdTableDirect 的 CommandTypeEnum 值与 Execute 配合使用。 这些值只能用作 Open 和 RequeryRecordset方法的选项。
注解
对 Command 对象使用 Execute 方法执行在对象的 CommandText 属性或 CommandStream 属性中指定的查询。
结果以 Recordset (默认情况下)或二进制信息流的形式返回。 若要获取二进制流,请在 Options 中指定 adExecuteStream,然后通过设置 Command.Properties(“Output Stream”)提供流。 可以指定 ADO Stream 对象来接收结果,也可以指定另一个流对象,例如 IIS 响应对象。 如果在使用 adExecuteStream 调用 Execute 之前未指定流,则会发生错误。 从 Execute 返回时流的位置特定于提供程序。
如果命令不打算返回结果(例如,SQL UPDATE 查询),只要指定了 adExecuteNoRecords ,提供程序将返回 Nothing;否则,Execute 返回已关闭的 Recordset。 如果不需要 Recordset ,某些应用程序语言允许忽略此返回值。
如果用户在 CommandType 为 adCmdStoredProc、adCmdTable 或 adCmdTableDirect 时为 CommandStream 指定值,则执行将引发错误。
如果查询具有参数,则使用 Command 对象的参数的当前值,除非使用 通过 Execute 调用传递的参数值重写这些值。 调用 Execute 方法时,可以通过省略某些参数的新值来替代参数的子集。 指定参数的顺序与方法传递参数的顺序相同。 例如,如果存在四个(或更多)参数,并且想要仅传递第一个和第四个参数的新值,则作为 Parameters 参数传递Array(var1,,,var4)
。
注释
输出参数在参数中传递时不会返回正确的值。
此作结束时将发出 ExecuteComplete 事件。
注释
发出包含 URL 的命令时,使用 http 方案的命令将自动调用 Microsoft OLE DB Provider for Internet Publishing。 有关详细信息,请参阅 绝对 URL 和相对 URL。
应用到
另请参阅
Execute、Requery 和 Clear 方法示例 (VB)
Execute、Requery 和 Clear 方法示例 (VBScript)
Execute、Requery 和 Clear 方法示例(VC++)
CommandStream 属性 (ADO)
CommandText 属性 (ADO)
CommandTypeEnum
Execute 方法(ADO 连接)
ExecuteComplete 事件 (ADO)