Execute 方法 （ADO 命令）

執行 CommandText 或 CommandStream屬性中指定的查詢、SQL 語句或預存程式，。

語法

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

傳回值

傳回 Recordset 物件參考、資料流或 Nothing。

參數

RecordAffected
自選。 Long 變數，提供者會傳回作業受影響的記錄數目。 RecordsAffected 參數僅適用於動作查詢或預存程式。 RecordsAffected 不會傳回結果傳回查詢或預存程式所傳回的記錄數目。 若要取得這項資訊，請使用 RecordCount 屬性。 Execute 方法在搭配 adAsyncExecute搭配使用時不會傳回正確的資訊，只是因為當命令以異步方式執行時，方法傳回時可能還不清楚受影響的記錄數目。

參數
自選。 Variant 參數值的陣列，與 commandText 或 commandStream 中所指定的輸入字串或數據流搭配使用。 （輸出參數在傳入這個自變數時不會傳回正確的值。

選項
自選。 Long 值，指出提供者應該如何評估 CommandText 或 CommandStream 物件的 CommandStream 屬性。 可以是 使用 CommandTypeEnum 和/或 ExecuteOptionEnum 值所建立的位掩碼值。 例如，如果您想要讓 ADO 評估 CommandText 屬性的值作為文字，則可以使用 adCmdText 和 adExecuteNoRecords 值，並指出命令應該捨棄，而不會傳回命令文字執行時可能產生的任何記錄。

注意

使用 ExecuteOptionEnum 值 adExecuteNoRecords，藉由將內部處理降至最低來改善效能。 如果已指定 adExecuteStream ，則會忽略 adAsyncFetch 和 adAsynchFetchNonBlocking 的選項。 請勿搭配 execute 使用 adCmdFile 或 adCmdTableDirectCommandTypeEnum 值。 這些值只能當做 Open 和 Requery 方法的選項使用，Recordset。

言論

在 Command 物件上使用 Execute 方法，會執行物件之 CommandText 屬性或 CommandStream 屬性中指定的查詢。

結果會以 Recordset （預設） 或二進位資訊的數據流傳回。 若要取得二進位數據流，請在 Options中指定 adExecuteStream，然後設定 Command.Properties（“Output Stream”）來提供數據流。 您可以指定 ADO Stream 物件來接收結果，也可以指定另一個數據流物件，例如 IIS 回應物件。 如果在呼叫具有 adExecuteStream 的 Execute之前未指定任何數據流，則會發生錯誤。 從 Execute 傳回的數據流位置為提供者特定。

如果命令不打算傳回結果（例如 SQL UPDATE 查詢），只要指定 adExecuteNoRecords 選項，提供者就會傳回 nothing Nothing;否則 Execute 會傳回關閉 Recordset。 某些應用程式語言可讓您忽略此傳回值，如果不需要 Recordset。

如果使用者指定 CommandStream 的值，則當 CommandType為 adCmdStoredProc、adCmdTable或 adCmdTableDirect時，Execute 會引發錯誤。

如果查詢具有參數，除非您以執行 呼叫 傳遞的參數值覆寫這些參數值，否則會使用 Command 物件參數的目前值。 呼叫 execute 方法時，您可以省略某些參數的新值，以覆寫參數的子集。 您指定參數的順序與方法傳遞它們的順序相同。 例如，如果有四個 （或更多） 參數，而且您想要只傳遞第一個和第四個參數的新值，您會傳遞 Array(var1,,,var4) 作為參數 自變數。

注意

輸出參數在傳入 Parameters 自變數時，將不會傳回正確的值。

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

注意

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

適用於

Command 物件 （ADO）

另請參閱

Execute、Requery 和 Clear 方法範例 （VB）
Execute、Requery 和 Clear 方法範例 （VBScript）
Execute、Requery 和 Clear 方法範例 （VC++）
CommandStream 屬性 （ADO）
CommandText 屬性 （ADO）
CommandTypeEnum
Execute 方法 （ADO 連線）
ExecuteComplete 事件 （ADO）