Execute21 メソッド (RDS)
要求を実行し、ADO 2.1 で使用する ADO レコードセットを作成します。
大事な
Windows 8 および Windows Server 2012 以降では、RDS サーバー コンポーネントは Windows オペレーティング システムに含まれません (詳細については、Windows 8 と Windows Server 2012 の互換性クックブック を参照してください)。 RDS クライアント コンポーネントは、将来のバージョンの Windows で削除される予定です。 新しい開発作業ではこの機能を使用しないでください。現在この機能を使用しているアプリケーションを変更することを計画してください。 RDS を使用するアプリケーションは、WCF Data Serviceに移行する必要があります。
構文
object.Execute21(ConnectionString As String, HandlerString As String, QueryString As String, lMarshalOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters)
パラメーター
ConnectionString の
実行のために要求が送信される OLE DB プロバイダーへの接続に使用される文字列。 HandlerString を使用してハンドラー指定した場合、接続文字列を編集または置換できます。
HandlerString
この文字列は、この実行で使用されるハンドラーを識別します。 文字列には 2 つの部分が含まれています。 最初の部分には、使用するハンドラーの名前 (ProgID) が含まれています。 文字列の 2 番目の部分には、ハンドラーに渡される引数が含まれています。 引数文字列の解釈方法はハンドラー固有です。 2 つの部分は、文字列内のコンマの最初のインスタンスで区切られます (ただし、引数文字列には追加のコンマを含めることができます)。 引数は省略可能です。
QueryString
接続文字列で識別される OLE DB プロバイダーでサポートされるコマンド言語のコマンド。 SQL ベースのプロバイダーの場合、Transact-SQL コマンド ステートメントが含まれている場合がありますが、SQL 以外のプロバイダー (MSDataShape など) の場合、これは Transact-SQL クエリ ステートメントではない可能性があります。
また、ハンドラーが使用されている場合 (ハンドラーを使用することを強くお勧めします)、ハンドラーはここで指定した値を変更または置き換えることができます。 たとえば、ハンドラーは通常、QueryString を .ini ファイルのクエリ文字列に置き換えます。 既定では、Msdfmap.ini ファイルが使用されます。
lMarshalOptions
返される行セット/レコードセットのマーシャリング オプションを設定するために使用します。
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 を する
パラメーター定義の安全な配列を含むバリアント。
GetInfo オプション lExecuteOptionsで指定した場合、このパラメーターは OLE DB プロバイダーから取得したパラメーター定義を返すために使用されます。 それ以外の場合、このパラメーターは空である可能性があります。
備考
HandlerString パラメーターは null にすることができます。 この場合の動作は、RDS サーバーの構成方法によって異なります。 "MSDFMAP.handler" のハンドラー文字列は、Microsoft が提供するハンドラー (Msdfmap.dll) を使用する必要があることを示します。 "MASDFMAP.handler,sample.ini" のハンドラー文字列は、Msdfmap.dll ハンドラーを使用する必要があり、引数 "sample.ini" をハンドラーに渡す必要があることを示します。 MSDFMAP.dll は、sample.ini を使用して接続とクエリ文字列を確認する方向として引数を解釈します。
手記
Execute21 メソッドは、Execute メソッド (RDS)のバージョンです。 Execute メソッドを使用して ADO 2.1 と通信する必要がある場合は、代わりに Execute21 メソッドを呼び出すことができます。 ADO 2.5 以降の Execute メソッドの機能は、ADO 2.1 の同じメソッドに対して提供される機能のスーパーセットです。