共用方式為


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 的錯誤。DataSpaceRDS。DataControl 物件不會載入,請確定您使用的是正確的類別標識碼。 這些物件的類別標識碼已從1.0版和1.1版變更。 此外,請注意,當您使用 RDS DataControl 物件時,甚至必須設定可為 Null 的數據行。

在基本案例中,您只需要設定 SQLConnectServerRDS 的屬性。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 屬性重新整理(明確或自動)。

  • 設定 CommandRecordset 屬性。

  • 使用 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 物件,請使用非零 HeightWidth 值,例如 1(以避免包含額外的空間)。

遠端數據服務用戶端元件已包含在 Internet Explorer 4.0 中;因此,您不需要在 RDS 中包含 CODEBASE 參數。DataControl 對象標記。

使用 Internet Explorer 4.0 或更新版本時,只有當 HTML 控件和 ActiveX 控件標示為 Apartment 模型控件時,才可以繫結至數據。

注意

Microsoft Visual Basic 使用者RDS。DataControl 對於腳本而言是安全的,而且只用於 Web 型應用程式中。 Visual Basic 用戶端應用程式不需要它。

本節包含下列主題。

另請參閱

DataControl 物件範例 (VBScript)