Execute 方法 (ADO Connection)

  • 發行項

執行指定的查詢、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 變數，提供者會將受作業影響的記錄數目傳回給此變數。

選項
選擇性。 Long 值，指出提供者應該如何評估 CommandText 引數。 可以是一或多個 CommandTypeEnum 或 ExecuteOptionEnum 值的位元遮罩。

注意：針對從 Visual Basic 6.0 移植的應用程式，使用 ExecuteOptionEnum 值 adExecuteNoRecords 可將內部處理降到最低來改善效能。

請勿搭配 Connection 物件的 Execute 方法使用 adExecuteStream。

請勿搭配 Execute 使用 adCmdFile 或 adCmdTableDirect 的 CommandTypeEnum 值。 這些值只能作為 Recordset 之 Open 方法 (ADO Recordset) 和 Requery 方法的選項。

備註

在 Connection 物件 (ADO) 上使用 Execute 方法，會執行您在指定連線上傳遞給 CommandText 引數中方法的任何查詢。 如果 CommandText 引數指定資料列傳回查詢，則執行所產生的任何結果都會儲存在新的 Recordset 物件中。 如果命令預期不會傳回結果 (例如 SQL UPDATE 查詢)，只要指定選項 adExecuteNoRecords，提供者就會傳回 Nothing；否則 Execute 會傳回已關閉的 Recordset。

傳回的 Recordset 物件一律是唯讀的順向資料指標。 如果您需要具有更多功能的 Recordset 物件，請先建立具有所需屬性設定的 Recordset 物件，然後使用 Recordset 物件的 Open 方法 (ADO Recordset) 來執行查詢並傳回所需的資料指標類型。

CommandText 引數的內容會視提供者而定，可以是標準 SQL 語法或提供者支援的任何特殊命令格式。

當此作業結束時，將會發出 ExecuteComplete 事件。

注意

使用 HTTP 配置的 URL 會自動叫用 Microsoft OLE DB Provider for Internet Publishing。 如需詳細資訊，請參閱絕對和相對 URL。

套用至

Connection 物件 (ADO)