Execute21 方法 (RDS)

  • 發行項

執行要求並建立 ADO 資料錄集，以便在 ADO 2.1 中使用。

重要

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

語法

  
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 開啟資料錄集，且任何隱藏的資料行都會包含在資料錄集中。

雖然 ReadOnly、NoBatch 和 GetHiddenColumns 是互斥的選項，但設定多個選項並非錯誤。 如果設定多個選項，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 方法 (RDS) 的一個版本。 在您需要使用 Execute 方法與 ADO 2.1 通訊時，可以改為呼叫 Execute21 方法。 ADO 2.5 和更新版本中 Execute 方法的功能，是 ADO 2.1 中針對相同方法所提供的功能聯集。

套用至

DataFactory 物件 (RDSServer)