Метод Execute (объект Command ADO)
Выполняет запрос, инструкцию SQL или хранимую процедуру, указанную в свойстве CommandText или CommandStream объекта CommandStream.
Синтаксис
Set recordset = command.Execute( RecordsAffected, Parameters, Options )
Возвращаемое значение
Возвращает ссылку на объект Recordset , поток или Nothing.
Параметры
RecordsAffected
Необязательно. Переменная Long , в которую поставщик возвращает количество записей, затронутых операцией. Параметр RecordsAffected применяется только для запросов действий или хранимых процедур. RecordsAffected не возвращает количество записей, возвращаемых результатом запроса или хранимой процедуры. Чтобы получить эти сведения, используйте свойство RecordCount . Метод Execute не возвращает правильные сведения при использовании с adAsyncExecute, просто так как при выполнении команды асинхронно количество затронутых записей может еще не быть известно во время возврата метода.
Параметры
Необязательно. Массив вариантов значений параметров, используемый в сочетании с входной строкой или потоком, указанным в CommandText или CommandStream. (Выходные параметры не возвращают правильные значения при передаче в этом аргументе.)
Параметры
Необязательно. Длинное значение, указывающее, как поставщик должен оценивать CommandText или свойство CommandStream объекта Command. Может быть битовой маской, сделанной с помощью значений CommandTypeEnum и/или ExecuteOptionEnum . Например, можно использовать adCmdText и adExecuteNoRecords в сочетании, если вы хотите оценить значение свойства CommandText в виде текста, а также указать, что команда должна отменить и не возвращать записи, которые могут быть созданы при выполнении текста команды.
Примечание.
Используйте значение ExecuteOptionEnum adExecuteNoRecords для повышения производительности путем минимизации внутренней обработки. Если adExecuteStream был указан, параметры adAsyncFetch и adAsynchFetchNonBlocking игнорируются. Не используйте значения CommandTypeEnum adCmdFile или adCmdTableDirect с Execute. Эти значения можно использовать только в качестве параметров с методами Open и Requery набора записей.
Замечания
Использование метода Execute в объекте Command выполняет запрос, указанный в свойстве CommandText или свойстве CommandStream объекта.
Результаты возвращаются в наборе записей (по умолчанию) или в виде потока двоичных данных. Чтобы получить двоичный поток, укажите adExecuteStream в разделе "Параметры", а затем укажите поток, задав command.Properties("Output Stream"). Объект ADO Stream можно указать для получения результатов или другого объекта потока, например объекта IIS Response. Если поток не указан перед вызовом Execute с adExecuteStream, возникает ошибка. Позиция потока при возврате из Execute зависит от поставщика.
Если команда не предназначена для возврата результатов (например, запроса SQL UPDATE), поставщик возвращает значение Nothing до тех пор, пока указан параметр adExecuteNoRecords ; в противном случае Execute возвращает закрытый набор записей. Некоторые языки приложений позволяют игнорировать это возвращаемое значение, если набор записей не требуется.
Выполнение вызывает ошибку, если пользователь задает значение Для CommandStream, если имя CommandType — adCmdStoredProc, adCmdTable или adCmdTableDirect.
Если запрос имеет параметры, текущие значения параметров объекта Command используются, если не переопределить их значениями параметров, переданными с помощью вызова Execute . Можно переопределить подмножество параметров, опустив новые значения для некоторых параметров при вызове метода Execute . Порядок, в котором указаны параметры, совпадает с порядком, в котором метод передает их. Например, если было четыре (или более) параметров, и вы хотели передать новые значения только для первых и четвертых параметров, вы будете передавать Array(var1,,,var4) в качестве аргумента "Параметры ".
Примечание.
Выходные параметры не возвращают правильные значения при передаче в аргументе Parameters .
Событие ExecuteComplete будет выдано при завершении этой операции.
Примечание.
При выдаче команд, содержащих URL-адреса, те, кто использует схему http, автоматически вызывают поставщика Microsoft OLE DB для публикации в Интернете. Дополнительные сведения см. в разделе "Абсолютные и относительные URL-адреса".
Применяется к
См. также
Пример методов Execute, Requery и Clear Methods (VB)
Пример методов Execute, Requery и Clear Methods (VBScript)
Пример методов Execute, Requery и Clear Methods (VC++)
Свойство CommandStream (ADO)
Свойство CommandText (ADO)
CommandTypeEnum
Метод Execute (объект Connection ADO)
Событие ExecuteComplete (ADO)