ADO実行メソッド
❮完全な接続オブジェクトリファレンス
Executeメソッドは、指定されたクエリ、SQLステートメント、ストアドプロシージャ、またはプロバイダー固有のテキストを実行します。
行を返すクエリの場合、結果は新しいRecordsetオブジェクトに保存されます。行を返すクエリでない場合は、閉じたRecordsetオブジェクトが返されます。
注：返されるRecordsetは、常に読み取り専用、転送専用のRecordsetです。
ヒント：より多くの機能を備えたRecordsetを作成するには、最初にRecordsetオブジェクトを作成します。必要なプロパティを設定してから、RecordsetオブジェクトのOpenメソッドを使用してクエリを実行します。
行を返すための構文
Set objrs=objconn.Execute(commandtext,ra,options)
行を返さないための構文
objconn.Execute commandtext,ra,options
| Parameter | Description |
|---|---|
| commandtext | Required. The SQL statement, stored procedure, or provider-specific text to execute |
| ra | Optional. The number of records affected by the query |
| options | Optional. Sets how the provider should evaluate the commandtext parameter. Can be one or more CommandTypeEnum or ExecuteOptionEnum values. Default is adCmdUnspecified |
例
<%
sql="SELECT companyname FROM Customers"
Set rs=conn.Execute(sql)
%>
CommandTypeEnum値
| Constant | Value | Description |
|---|---|---|
| adCmdUnspecified | -1 | Does not specify the command type argument. |
| adCmdText | 1 | Evaluates CommandText as a textual definition of a command or stored procedure call. |
| adCmdTable | 2 | Evaluates CommandText as a table name whose columns are all returned by an internally generated SQL query. |
| adCmdStoredProc | 4 | Evaluates CommandText as a stored procedure name. |
| adCmdUnknown | 8 | Indicates that the type of command in the CommandText property is not known. |
| adCmdFile | 256 | Evaluates CommandText as the file name of a persistently stored Recordset. Used with Recordset.Open or Requery only. |
| adCmdTableDirect | 512 | Evaluates CommandText as a table name whose columns are all returned. Used with Recordset.Open or Requery only. To use the Seek method, the Recordset must be opened with adCmdTableDirect. This value cannot be combined with the ExecuteOptionEnum value adAsyncExecute. |
ExecuteOptionEnum値
| Constant | Value | Description |
|---|---|---|
| adOptionUnspecified | -1 | Indicates that the command is unspecified. |
| adAsyncExecute | Indicates that the command should execute asynchronously. This value cannot be combined with the CommandTypeEnum value adCmdTableDirect. | |
| adAsyncFetch | Indicates that the remaining rows after the initial quantity specified in the CacheSize property should be retrieved asynchronously. | |
| adAsyncFetchNonBlocking | Indicates that the main thread never blocks while retrieving. If the requested row has not been retrieved, the current row automatically moves to the end of the file. If you open a Recordset from a Stream containing a persistently stored Recordset, adAsyncFetchNonBlocking will not have an effect; the operation will be synchronous and blocking. adAsynchFetchNonBlocking has no effect when the adCmdTableDirect option is used to open the Recordset. | |
| adExecuteNoRecords | Indicates that the command text is a command or stored procedure that does not return rows (for example, a command that only inserts data). If any rows are retrieved, they are discarded and not returned. adExecuteNoRecords can only be passed as an optional parameter to the Command or Connection Execute method. | |
| adExecuteStream | Indicates that the results of a command execution should be returned as a stream. adExecuteStream can only be passed as an optional parameter to the Command Execute method. | |
| adExecuteRecord | Indicates that the CommandText is a command or stored procedure that returns a single row which should be returned as a Record object. |
❮完全な接続オブジェクトリファレンス