共用方式為


Execute 方法 (RDS)

執行要求並建立 ADO 資料錄集,以便在 ADO 2.5 與更新版本中使用。

重要

從 Windows 8 和 Windows Server 2012 開始,Windows 作業系統中不再包含 RDS 伺服器元件 (請參閱 Windows 8 和 Windows Server 2012 相容性操作手冊以取得詳細資訊)。 未來的 Windows 版本將移除 RDS 用戶端元件。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 使用 RDS 的應用程式應該移轉至 WCF 資料服務

語法

  
object.Execute(ConnectionString As String, HandlerString As String, QueryString As String, lFetchOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters, [lcid As Long], [pInformation])  

參數

ConnectionString
用來連線到 OLE DB 提供者 (其將接收要求以便執行) 的字串。 如果使用 HandlerString 指定處理常式,其便可以編輯或取代連接字串。

HandlerString
可識別要搭配此執行使用之處理常式的兩部分字串。 該字串包含兩個部分。 第一部分包含要使用的處理常式名稱 (ProgID)。 第二部分包含要傳遞至處理常式的引數。 引數字串解譯方式的詳細資料是每個處理常式特有的。 這兩部分會以字串中的第一個逗號來分隔。 引數字串可包含更多逗號。 引數是選擇性的。

QueryString
在連接字串中識別之 OLE DB 提供者所支援命令語言中的命令。 針對 SQL 型提供者,QueryString 可能包含 Transact-SQL 命令陳述式,但針對非 SQL 提供者 (例如 MSDataShape),這可能不會是 Transact-SQL 查詢陳述式。

如果使用處理程式,處理常式可以改變或取代這裡指定的值。 例如,處理常式通常會以來自其 .ini 檔案中的查詢字串取代 QueryString。 根據預設,系統會使用 Msdfmap.ini 檔案。

lFetchOptions
指出非同步擷取的類型。

如需詳細資訊,請參閱 FetchOptions 屬性 (RDS) (英文)。

TableID
VT_EMPTY 或 VT_BSTR 類型的變體。 如果此值為 VT_EMPTY 類型,系統會予以忽略。 如果為 VT_BSTR 類型,系統會使用 adCmdTableDirect 與此處所指定的值來建立資料錄集,並忽略 QueryString 參數。

lExecuteOptions
執行選項的位元遮罩:

1=ReadOnly 將使用 adLockReadOnly 開啟資料錄集。

2=NoBatch 使用 adLockOptimistic 開啟資料錄集。

4=AllParamInfoSupplied 呼叫者保證 pParameters 中提供所有參數的參數資訊。

8=GetInfo 查詢的參數資訊將從 OLE DB 提供者取得,並在 pParameters 參數中傳回。 不會執行查詢,也不會傳回任何資料錄集。

16=GetHiddenColumns 使用 adLockBatchOptimistic 開啟資料錄集,且任何隱藏的資料行都會包括在資料錄集中。

雖然 ReadOnlyNoBatchGetHiddenColumns 是互斥的選項,但設定多個選項並不會產生錯誤。 如果設定多個選項,GetHiddenColumns 會較其他選項擁有較高的優先順序,而緊接在其後的則是 ReadOnly。 如果未指定任何選項,在預設情況下會使用 adLockBatchOptimistic 開啟資料錄集,且資料錄集中不會包括隱藏的資料行。

pParameters
包含安全的參數定義陣列的變數。 如果 lExecuteOptions 中已指定 GetInfo 選項,這個參數會用來傳回從 OLE DB 提供者取得的參數定義。 否則,此參數可為空白。

lcid
LCID 用來建置 pInformation 中傳回的任何錯誤。

pInformation
Execute 所傳回資訊錯誤的指標。 如果為 NULL,則不會傳回任何錯誤資訊。

備註

HandlerString 參數可為 Null。 在此情況下會發生什麼情況,取決於 RDS 伺服器的設定方式。 "MSDFMAP.handler" 的處理常式字串,表示應使用 Microsoft 提供的處理常式 (Msdfmap.dll)。 "MASDFMAP.handler,sample.ini" 的處理常式字串,表示應使用 Msdfmap.dll 處理常式,且應將引數 "sample.ini" 傳遞至該處理常式。 MSDFMAP.dll 會將引數解譯為使用 sample.ini 來檢查連線與查詢字串的指示。

套用至

DataFactory 物件 (RDSServer)