Execute メソッド (RDS)
要求を実行し、ADO 2.5 以降で使用する ADO レコードセットを作成します。
大事な
Windows 8 および Windows Server 2012 以降では、RDS サーバー コンポーネントは Windows オペレーティング システムに含まれません (詳細については、Windows 8 と Windows Server 2012 の互換性クックブック を参照してください)。 RDS クライアント コンポーネントは、将来のバージョンの Windows で削除される予定です。 新しい開発作業ではこの機能を使用しないでください。現在この機能を使用しているアプリケーションを変更することを計画してください。 RDS を使用するアプリケーションは、WCF Data Serviceに移行する必要があります。
構文
object.Execute(ConnectionString As String, HandlerString As String, QueryString As String, lFetchOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters, [lcid As Long], [pInformation])
パラメーター
ConnectionString の
実行のために要求が送信される OLE DB プロバイダーへの接続に使用される文字列。 HandlerString 使用してハンドラーを指定した場合は、接続文字列を編集または置換できます。
HandlerString
この実行で使用するハンドラーを識別する 2 部構成の文字列。 文字列には 2 つの部分が含まれています。 最初の部分には、使用するハンドラーの名前 (ProgID) が含まれています。 2 番目の部分には、ハンドラーに渡される引数が含まれています。 引数文字列の解釈方法の詳細は、各ハンドラーに固有です。 2 つの部分は、文字列内のコンマの最初のインスタンスで区切られます。 引数文字列には、追加のコンマを含めることができます。 引数は省略可能です。
QueryString
接続文字列で識別される OLE DB プロバイダーでサポートされるコマンド言語のコマンド。 SQL ベースのプロバイダーの場合、QueryString には Transact-SQL コマンド ステートメントが含まれる場合がありますが、SQL 以外のプロバイダー (MSDataShape など) の場合、これは Transact-SQL クエリ ステートメントではない可能性があります。
ハンドラーが使用されている場合、ハンドラーはここで指定した値を変更または置き換えることができます。 たとえば、ハンドラーは通常、QueryString を .ini ファイルのクエリ文字列に置き換えます。 既定では、Msdfmap.ini ファイルが使用されます。
lFetchOptions
非同期フェッチの種類を示します。
詳細については、「 FetchOptions プロパティ (RDS)を参照してください。
TableID の
バリアント型の VT_EMPTYまたはVT_BSTR。 この値がVT_EMPTY型の場合は無視されます。 VT_BSTR型の場合、adCmdTableDirect を使用してレコードセットが作成され、ここで指定した値と QueryString パラメーターは無視されます。
lExecuteOptions
実行オプションのビット マスク:
1=読み取りonly レコードセットは、adLockReadOnlyを使用して開きます。
2=NoBatch レコードセットは、adLockOptimistic 使用して開かれます。
4=AllParamInfoSupplied 呼び出し元は、すべてのパラメーターのパラメーター情報が pParameters で提供されることを保証します。
8=GetInfo クエリのパラメーター情報は OLE DB プロバイダーから取得され、pParameters パラメーターで返されます。 クエリは実行されず、レコードセットは返されません。
16=GetHiddenColumns adLockBatchOptimistic 使用してレコードセットが開き、非表示の列がレコードセットに含まれます。
ReadOnly、NoBatch、GetHiddenColumns は相互に排他的なオプションです。ただし、複数のエラーを設定してもエラーは生成されません。 複数のオプションが設定されている場合、GetHiddenColumns が他のすべてのオプションよりも優先され、その後に ReadOnly 優先されます。 オプションが指定されていない場合、既定では、adLockBatchOptimistic 使用してレコードセットが開き、非表示の列はレコードセットに含まれません。
pParameters を する
パラメーター定義の安全な配列を含む Variant。
GetInfo オプション lExecuteOptionsで指定した場合、このパラメーターは OLE DB プロバイダーから取得したパラメーター定義を返すために使用されます。 それ以外の場合、このパラメーターは空にすることができます。
lcid を する
pInformationで返されるエラーをビルドするために使用される LCID。
pInformation の
Execute によって返される情報エラーへのポインター。 NULL の場合、エラー情報は返されません。
備考
HandlerString パラメーターは null にすることができます。 この場合の動作は、RDS サーバーの構成方法によって異なります。 "MSDFMAP.handler" のハンドラー文字列は、Microsoft が提供するハンドラー (Msdfmap.dll) を使用する必要があることを示します。 "MASDFMAP.handler,sample.ini" のハンドラー文字列は、Msdfmap.dll ハンドラーを使用する必要があり、引数 "sample.ini" をハンドラーに渡す必要があることを示します。 MSDFMAP.dll は、sample.ini を使用して接続とクエリ文字列を確認する方向として引数を解釈します。