DataControl オブジェクト (RDS)

[アーティクル]
04/04/2023

適用先: Access 2013、Office 2013

データクエリ Recordset を 1 つ以上のコントロール (テキストボックス、グリッドコントロール、コンボボックスなど) にバインドして、 Recordset データを Web ページに表示します。

構文

    <OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33" ID="DataControl"
       <PARAM NAME="Connect" VALUE="DSN=DSNName;UID=usr;PWD=pw;">
       <PARAM NAME="Server" VALUE="https://awebsrvr">
       <PARAM NAME="SQL" VALUE="QueryText">
    </OBJECT>

注釈

RDS.DataControl オブジェクトのクラス ID は、BD96C556-65A3-11D0-983A-00C04FC29E33 です。

注:

[!メモ] RDS.DataSpace オブジェクトまたは RDS.DataControl オブジェクトを読み込むことができないというエラーが発生した場合は、正しいクラス ID を使用していることを確認してください。これらのオブジェクトのクラス ID は、バージョン 1.0 とバージョン 1.1 から変更されています。

基本的なシナリオでは、既定のビジネスオブジェクトの RDSServer.DataFactory を自動的に呼び出す、 RDS.DataControl オブジェクトの SQL 、 Connect 、および Server の各プロパティのみ設定する必要があります。

RDS.DataControl のすべてのプロパティは、カスタムのビジネスオブジェクトでその機能を置き換えられるため省略可能です。

注:

[!メモ] 複数の結果を求めるクエリを実行すると、最初の Recordset のみ取得されます。複数の結果セットが必要な場合は、それぞれを独自の DataControl に割り当てます。

複数の結果のクエリの例を次に示します "Select * from Authors, Select * from Topics"。

RDS.DataControl オブジェクトを使用する場合、接続文字列に "DFMode=20;" を追加すると、データ更新時のサーバーのパフォーマンスを向上させることができます。この設定によって、サーバー上の 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=usr;PWD=pw;">
       <PARAM NAME="Server" VALUE="https://awebsrvr">
       <PARAM NAME="SQL" VALUE="QueryText">
       <PARAM NAME="ExecuteOptions" VALUE="1">
       <PARAM NAME="FetchOptions" VALUE="1">
    </OBJECT>

単一のクエリの結果を 1 つまたは複数のビジュアルコントロールにリンクするには、1 つの RDS.DataControl オブジェクトを使用します。たとえば、名前、住居、出生地、年齢、優先得意先ステータスなどの顧客データを要求するクエリのコードを作成するとします。この場合、1 つの RDS.DataControl オブジェクトを使用して、顧客の名前、年齢、地域を 3 つの異なるテキストボックスに、優先顧客ステータスを 1 つのチェックボックスに、すべてのデータをグリッドコントロールに表示できます。

複数のクエリの結果を異なるビジュアルコントロールにリンクするには、異なる RDS.DataControl オブジェクトを使用します。たとえば、1 つ目のクエリを使用して得意先に関する情報を取得し、2 つ目のクエリを使用して得意先が購入した商品に関する情報を取得するとします。最初のクエリの結果を 3 つのテキストボックスと 1 つのチェックボックスに、2 つ目のクエリの結果をグリッドコントロールに表示します。既定のビジネスオブジェクト (RDSServer.DataFactory) を使用する場合、次のような操作を実行する必要があります。

2 つの RDS を追加 します。Web ページへの DataControl オブジェクト。
2 つの RDS.DataControl オブジェクトの各 SQL プロパティに 1 つずつ、合計 2 つのクエリを記述します。 1 つ目の RDS.DataControl オブジェクトには、顧客の情報を要求する SQL クエリを、2 つ目のオブジェクトには、顧客が購入した商品の一覧を要求するクエリを格納します。
連結コントロールの各 OBJECT タグで、DATAFLD 値を指定して、各ビジュアルコントロールに表示するデータの値を設定します。

RDS の数にカウント制限はありません。単一の Web ページに OBJECT タグを使用して埋め込むことができる DataControl オブジェクト。

RDS を定義する場合 。Web ページ上の DataControl オブジェクトでは、0 以外の Height 値と Width 値 (1 など) を使用します (余分なスペースが含まれないようにするため)。

リモートデータサービスのクライアントコンポーネントは、Internet Explorer 4.0 の一部として既に組み込まれています。このため、 RDS.DataControl オブジェクトのタグに、CODEBASE パラメーターを含める必要はありません。

インターネットエクスプローラー 4.0 以降では、HTML コントロールと ActiveX コントロールがアパートメントモデルコントロールとしてマークされている場合にのみ、データにバインドできます。

Microsoft Visual Basic ユーザーRDS。DataControl は、Web ベースのアプリケーションでのみ使用されます。 Visual Basic クライアントアプリケーションでは不要です。

DataControl オブジェクト (RDS)

構文

注釈

その他のリソース