執(zhí)行在 CommandText 屬性中指定的查詢、SQL 語句或存儲過程。
語法
對于按行返回的 Command:
Set recordset = command.Execute( RecordsAffected, Parameters, Options )
對于非按行返回的 Command:
command.Execute RecordsAffected, Parameters, Options
返回值
返回 Recordset 對象引用。
參數(shù)
RecordsAffected 可選,長整型變量,提供者向其返回操作所影響的記錄數(shù)目。RecordsAffected 參數(shù)僅應(yīng)用于操作查詢或存儲過程。RecordsAffected 不返回由返回結(jié)果的查詢或存儲過程所返回的記錄數(shù)目。詳細(xì)信息,請使用 RecordCount 屬性。
Parameters 可選,變體型數(shù)組,使用 SQL 語句傳送的參數(shù)值。(用該參數(shù)傳送時輸出參數(shù)將不返回正確值。)
Options 可選,長整型值,指示提供者如何計算 Command 對象的 CommandText 屬性。該值可為下列常量之一:
常量 |
說明 |
AdCmdText |
指示提供者應(yīng)按命令的文本定義(如 SQL 語句)來計算 CommandText。 |
AdCmdTable |
指示 ADO 應(yīng)生成 SQL 查詢以便從 CommandText 命名的表中返回所有行。 |
AdCmdTableDirect |
指示提供者應(yīng)從 CommandText 命名的表中返回所有行。 |
AdCmdStoredProc |
指示提供者應(yīng)按存儲過程計算 CommandText。 |
AdCmdUnknown |
指示 CommandText 中的命令類型未知。 |
adAsyncExecute |
指示命令應(yīng)異步執(zhí)行。 |
adAsyncFetch |
指示對由 CacheSize 屬性指定的初始數(shù)量之后的剩余行應(yīng)使用異步提取。 |
本列表中前 4 個常量的詳細(xì)說明請參見 CommandType 屬性。
說明
使用 Command 對象的 Execute 方法可執(zhí)行在對象的 CommandText 屬性中指定的查詢。如果 CommandText 屬性指定按行返回查詢,執(zhí)行所產(chǎn)生的任何結(jié)果都將存儲在新的 Recordset 對象中。如果該命令不是按行返回查詢,則提供者返回關(guān)閉的 Recordset 對象。某些應(yīng)用程序語言允許忽略該返回值(如果不需要任何 Recordset)。
如果查詢帶有參數(shù),將使用 Command 對象中參數(shù)的當(dāng)前值,除非通過 Execute 調(diào)用傳送的參數(shù)覆蓋它們??梢栽谡{(diào)用 Execute 方法時通過省略某些參數(shù)的新值來覆蓋參數(shù)子集。指定參數(shù)的次序與其在方法中被傳送的次序相同。例如,如果有 4 個(或更多)參數(shù)并且希望只為第一個和第四個參數(shù)傳送新值,則可以將 Array(var1,,,var4) 作為 Parameters 參數(shù)傳送。
注意 在 Parameters 參數(shù)中傳送時輸出參數(shù)將不返回正確的值。
該操作結(jié)束后將發(fā)出 ExecuteComplete 事件。