Execute 方法 (RDS)
執行要求,並建立 ADO 記錄集以用於 ADO 2.5 和更新版本。
重要
從 Windows 8 和 Windows Server 2012 開始,RDS 伺服器元件已不再包含在 Windows 作業系統中(如需詳細資訊,請參閱 Windows 8 和 Windows Server 2012 兼容性 Cookbook)。 RDS 用戶端元件將在未來的 Windows 版本中移除。 請避免在新的開發工作中使用此功能,並計劃修改目前使用此功能的應用程式。 使用 RDS 的應用程式應該移至 WCF Data Service。
語法
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類型的 Variant。 如果此值的類型為 VT_EMPTY,則會忽略此值。 如果記錄集的類型為 VT_BSTR,則會使用 adCmdTableDirect 建立記錄集,並忽略此處指定的值,並忽略 QueryString 參數。
lExecuteOptions
執行選項的位元遮罩:
1=ReadOnly 使用 adLockReadOnly 來開啟記錄集。
2=NoBatch 使用 adLockOptimistic 開啟記錄集。
4=AllParamInfoSupplied 呼叫端保證所有參數的參數資訊都會在 pParameters 中提供。
8=GetInfo 查詢的參數資訊會從 OLE DB 提供者取得,並在 pParameters 參數中傳回。 不會執行查詢,也不會傳回任何記錄集。
16=GetHiddenColumns 記錄集將會使用 adLockBatchOptimistic 開啟,而且任何隱藏的數據行都會包含在記錄集中。
ReadOnly、NoBatch 和 GetHiddenColumns 是互斥的選項:不過,它不會產生錯誤來設定其中一個以上的錯誤。 如果設定多個選項,GetHiddenColumns 優先於所有其他選項,後面接著 ReadOnly。 如果未指定任何選項,則記錄集預設會使用 adLockBatchOptimistic 開啟記錄集,而且不會包含隱藏的數據行。
pParameters
Variant,其中包含安全的參數定義數位。 如果在 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 檢查連接和查詢字串的方向。