DataControl 物件 (RDS)
將數據查詢系結 Recordset 至一或多個控件(例如文本框、方格控件或下拉式方塊),以顯示網頁上 Recordset 數據。
重要
從 Windows 8 和 Windows Server 2012 開始,RDS 伺服器元件已不再包含在 Windows 作業系統中(如需詳細資訊,請參閱 Windows 8 和 Windows Server 2012 兼容性 Cookbook)。 RDS 用戶端元件將在未來的 Windows 版本中移除。 請避免在新的開發工作中使用此功能,並計劃修改目前使用此功能的應用程式。 使用 RDS 的應用程式應該移至 WCF Data Service。
語法
<OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33" ID="DataControl"
<PARAM NAME="Connect" VALUE="DSN=DSNName;UID=MyUserID;PWD=<password>;">
<PARAM NAME="Server" VALUE="https://awebsrvr">
<PARAM NAME="SQL" VALUE="QueryText">
</OBJECT>
言論
RDS 的類別標識碼。DataControl 對像是 BD96C556-65A3-11D0-983A-00C04FC29E33。
注意
如果您收到 RDS 的錯誤。DataSpace 或 RDS。DataControl 物件不會載入,請確定您使用的是正確的類別標識碼。 這些物件的類別標識碼已從1.0版和1.1版變更。 此外,請注意,當您使用 RDS DataControl 物件時,甚至必須設定可為 Null 的數據行。
在基本案例中,您只需要設定 SQL、Connect和 ServerRDS 的屬性。DataControl 物件,會自動呼叫預設商務物件,RDSServer.DataFactory。
RDS 中的所有屬性。DataControl 是選擇性的,因為自定義商務物件可以取代其功能。
注意
如果您查詢多個結果,只會傳回第一個 Recordset。 如果需要多個結果集,請將每個結果集指派給自己的 DataControl。 查詢多個結果的范例如下:"Select * from Authors, Select * from Topics"
當您使用 RDS 時,將 「DFMode=20;」 新增至連接字串。當您更新數據時,DataControl 物件可以改善伺服器的效能。 使用此設定,伺服器上的 RDSServer.DataFactory 物件會使用較不密集的資源模式。 不過,此設定中無法使用下列功能:
使用參數化查詢。
先取得參數或數據行資訊,再呼叫 Execute 方法。
將 Transact Updates 設定為 true 。
取得數據列狀態。
呼叫 Resync 方法。
透過 Update Resync 屬性重新整理(明確或自動)。
設定 Command 或 Recordset 屬性。
使用 adCmdTableDirect。
RDS。DataControl 對象預設會以異步模式執行。 如果您需要應用程式的同步執行,請將 ExecuteOptions 參數設定為等於 adcExecSync,並將 FetchOptions 參數設定為等於 adcFetchUpFront,如下列範例所示。
<OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33"
ID="DataControl"
<PARAM NAME="Connect" VALUE="DSN=DSNName;UID=MyUserID;PWD=<password>;">
<PARAM NAME="Server" VALUE="https://awebsrvr">
<PARAM NAME="SQL" VALUE="QueryText">
<PARAM NAME="ExecuteOptions" VALUE="1"> <PARAM NAME="FetchOptions" VALUE="1">
</OBJECT>
使用一個 RDS。DataControl 物件,將單一查詢的結果連結至一或多個視覺控件。 例如,假設您撰寫查詢來要求客戶數據,例如名稱、居住地、出生地點、年齡和優先順序客戶狀態。 您可以使用單一 RDS。DataControl 物件,在三個不同的文本框中顯示客戶的 [名稱]、[年齡] 和 [區域] ;選取框中的優先順序客戶狀態;和方格控件中的所有數據。
使用不同的 RDS。DataControl 物件,將多個查詢的結果連結至不同的視覺控件。 例如,假設您使用一個查詢來取得客戶的相關信息,第二個查詢可取得客戶已購買之商品的相關信息。 您想要在三個文本框和一個複選框中顯示第一個查詢的結果,以及方格控件中第二個查詢的結果。 如果您使用預設商務物件 (RDSServer.DataFactory),您必須執行下列動作:
新增兩個 RDS。DataControl 物件到您的網頁。
針對兩個 RDS 的每個 SQL 屬性寫入兩個查詢。DataControl 物件。 一個 RDS。DataControl 物件將包含要求客戶資訊的 SQL 查詢;第二個將包含查詢,要求客戶購買的商品清單。
在每個綁定控件的 OBJECT 標記中,指定 DATAFLD 值,以設定您想要在每個視覺控件中顯示的數據值。
RDS 數目沒有計數限制。DataControl 物件,您可以在單一網頁上使用 OBJECT 標籤來內嵌。
當您定義 RDS 時。網頁上的 DataControl 物件,請使用非零 Height 和 Width 值,例如 1(以避免包含額外的空間)。
遠端數據服務用戶端元件已包含在 Internet Explorer 4.0 中;因此,您不需要在 RDS 中包含 CODEBASE 參數。DataControl 對象標記。
使用 Internet Explorer 4.0 或更新版本時,只有當 HTML 控件和 ActiveX 控件標示為 Apartment 模型控件時,才可以繫結至數據。
注意
Microsoft Visual Basic 使用者RDS。DataControl 對於腳本而言是安全的,而且只用於 Web 型應用程式中。 Visual Basic 用戶端應用程式不需要它。
本節包含下列主題。