Execute 方法(ADO 连接)

执行指定的查询、SQL 语句、存储过程或提供程序特定的文本。

语法

  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  

返回值

返回 Recordset 对象 (ADO) 对象引用。

参数

CommandText
字符串值,其中包含要执行的 SQL 语句、存储过程、URL 或提供程序特定的文本。 (可选)可使用表名称,但前提是提供程序支持 SQL。 例如,如果使用“Customers”表名称,ADO 将自动预置标准 SQL Select 语法以形成并将“SELECT * FROM Customers”作为 Transact-SQL 语句传递给提供程序。

RecordsAffected
可选。 提供程序返回操作受影响的记录数的 Long 变量。

选项
可选。 指示提供程序应如何计算 CommandText 参数的 Long 值。 可以是一个或多个 CommandTypeEnumExecuteOptionEnum 值的位掩码。

注意:使用 ExecuteOptionEnum 值 adExecuteNoRecords 通过最大限度地减少内部处理来提高性能,并用于从 Visual Basic 6.0 移植的应用程序。

请勿将 adExecuteStream 与 Connection 对象的 Execute 方法结合使用。

请勿将 adCmdFile 或 adCmdTableDirect 的 CommandTypeEnum 值与 Execute 结合使用。 这些值只能用作 Recordset 的 Open 方法 (ADO Recordset)Requery 方法方法的选项。

备注

Connection 对象 (ADO) 对象上使用 Execute 方法会在指定的连接上执行在 CommandText 参数中传递给该方法的任何查询。 如果 CommandText 参数指定行返回查询,则执行生成的任何结果都存储在新的 Recordset 对象中。 如果命令不打算返回结果(例如,SQL UPDATE 查询),只要指定了选项 adExecuteNoRecords,提供程序就不会反返回任何内容;否则 Execute 返回一个已关闭的 Recordset。

返回的 Recordset 对象始终是只读、只进游标。 如果需要一个具有更多功能的 Recordset 对象,首先创建一个具有所需属性设置的 Recordset 对象,然后使用 Recordset 对象的 Open 方法 (ADO Recordset) 方法执行查询并返回所需的游标类型。

CommandText 参数的内容特定于提供程序,可以是标准 SQL 语法或提供程序支持的任何特殊命令格式。

此操作结束时,将引发 ExecuteComplete 事件。

注意

使用 http 方案的 URL 将自动调用用于 Internet 发布的 Microsoft OLE DB 提供程序。 有关详细信息,请参阅绝对 URL 和相对 URL

应用于

连接对象 (ADO)