共用方式為


Execute21 方法 (RDS)

執行要求,並建立 ADO 記錄集以用於 ADO 2.1。

重要

從 Windows 8 和 Windows Server 2012 開始,RDS 伺服器元件已不再包含在 Windows 作業系統中(如需詳細資訊,請參閱 Windows 8 和 Windows Server 2012 兼容性 Cookbook)。 RDS 用戶端元件將在未來的 Windows 版本中移除。 請避免在新的開發工作中使用此功能,並計劃修改目前使用此功能的應用程式。 使用 RDS 的應用程式應該移至 WCF Data Service

語法

  
object.Execute21(ConnectionString As String, HandlerString As String, QueryString As String, lMarshalOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters)  

參數

ConnectionString
用來連線到 OLE DB 提供者的字串,要求將傳送至執行位置。 如果使用 HandlerString來指定處理程式,則可以編輯或取代連接字串。

HandlerString
字串會識別要與這個執行搭配使用的處理程式。 字串包含兩個部分。 第一個部分包含要使用的處理程式名稱(ProgID)。 字串的第二個部分包含要傳遞至處理程式的自變數。 如何解譯自變數字串是處理程式特定的。 這兩個部分會以字串中逗號的第一個實例分隔(雖然自變數字串可以包含其他逗號)。 自變數是選擇性的。

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

此外,如果使用處理程式(而且強烈建議使用處理程式),處理程式可以改變或取代此處指定的值。 例如,處理程式通常會以 .ini 檔案中的查詢字串取代 QueryString。 根據預設,會使用 Msdfmap.ini 檔案。

lMarshalOptions
用來設定傳回之數據列集/記錄集上的封送處理選項。

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 提供者取得的參數定義。 否則,此參數可能是空的。

言論

HandlerString 參數可能是 null。 在此情況下,會發生什麼情況取決於 RDS 伺服器的設定方式。 “MSDFMAP.handler” 的處理程式字串表示應該使用Microsoft提供的處理程式(Msdfmap.dll)。 “MASDFMAP.handler,sample.ini” 的處理程式字串表示應該使用 Msdfmap.dll 處理程式,而且應該將自變數 “sample.ini” 傳遞給處理程式。 MSDFMAP.dll 會將自變數解譯為使用 sample.ini 檢查連接和查詢字串的方向。

注意

Execute21 方法是 Execute 方法的版本。 如果您需要使用 Execute 方法來與 ADO 2.1 通訊,可以改為呼叫 Execute21 方法。 ADO 2.5 和更新版本中 Execute 方法的功能是針對 ADO 2.1 中相同方法所提供的功能超集。

適用於

DataFactory 物件 (RDSServer)