DataControl オブジェクト (RDS)
Recordset データ クエリを 1 つ以上のコントロール (テキスト ボックス、グリッド コントロール、コンボ ボックスなど) にバインドして、Recordset データを Web ページに表示します。
大事な
Windows 8 および Windows Server 2012 以降では、RDS サーバー コンポーネントは Windows オペレーティング システムに含まれません (詳細については、Windows 8 と Windows Server 2012 の互換性クックブック を参照してください)。 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 のクラス ID。DataControl オブジェクトは BD96C556-65A3-11D0-983A-00C04FC29E33 です。
手記
RDS というエラーが発生した場合。DataSpace または RDS。DataControl オブジェクトが読み込まれない場合は、正しいクラス ID を使用していることを確認してください。 これらのオブジェクトのクラス ID は、バージョン 1.0 および 1.1 から変更されました。 また、RDS DataControl オブジェクトを使用する場合は、null 許容列も設定する必要があることに注意してください。
基本的なシナリオでは、RDS の SQL、Connect、Server プロパティのみを設定する必要があります。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 プロパティを使用した更新 (明示的または自動的)。
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 1 つを使用します。DataControl オブジェクトを使用して、1 つのクエリの結果を 1 つ以上のビジュアル コントロールにリンクします。 たとえば、Name、Residence、Place of Birth、Age、Priority Customer Status などの顧客データを要求するクエリをコーディングするとします。 1 つの RDS を使用できます。DataControl 3 つの個別のテキスト ボックスに顧客の名前、年齢、および地域を表示するオブジェクトです。チェック ボックス内の顧客ステータスの優先順位。およびグリッド コントロール内のすべてのデータ。
別の RDS を使用します。DataControl オブジェクトを使用して、複数のクエリの結果をさまざまなビジュアル コントロールにリンクします。 たとえば、あるクエリを使用して顧客に関する情報を取得し、2 つ目のクエリを使用して顧客が購入した商品に関する情報を取得するとします。 最初のクエリの結果を 3 つのテキスト ボックスと 1 つのチェック ボックスに表示し、2 番目のクエリの結果をグリッド コントロールに表示します。 既定のビジネス オブジェクト (RDSServer.DataFactory) を使用する場合は、次の操作を行う必要があります。
RDS 2 つ追加します。DataControl オブジェクトを Web ページに追加します。
2 つの RDS の SQL プロパティ ごとに 1 つずつ、2 つのクエリを記述します。DataControl オブジェクト。 RDS 1 つ。DataControl オブジェクトには、顧客情報を要求する SQL クエリが含まれます。2 つ目には、顧客が購入した商品の一覧を要求するクエリが含まれます。
バインドされた各コントロールの OBJECT タグで、DATAFLD 値を指定して、各ビジュアル コントロールに表示するデータの値を設定します。
RDS の数にカウント制限はありません。DataControl 1 つの Web ページで OBJECT タグを使用して埋め込むことができるオブジェクトです。
RDS を定義する場合。DataControl Web ページ上のオブジェクトでは、0 以外の Height を使用し、幅 値 (1 など) を します (余分なスペースが含まれないようにするため)。
リモート データ サービス クライアント コンポーネントは、Internet Explorer 4.0 の一部として既に含まれています。そのため、RDS に CODEBASE パラメーターを含める必要はありません。DataControl オブジェクト タグ。
Internet Explorer 4.0 以降では、HTML コントロールと ActiveX コントロールがアパートメント モデル コントロールとしてマークされている場合にのみ、データにバインドできます。
手記
RDS Microsoft Visual Basic Users を します。DataControl はスクリプト作成に安全であり、Web ベースのアプリケーションでのみ使用されます。 Visual Basic クライアント アプリケーションには必要ありません。
このセクションには、次のトピックが含まれています。