Метод Execute (объект Connection ADO)
Выполняет указанный запрос, инструкцию SQL, хранимую процедуру или текст, зависящий от поставщика.
Синтаксис
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)
Возвращаемое значение
Возвращает ссылку на объект Recordset Object (ADO).
Параметры
CommandText
Строковое значение, содержащее инструкцию SQL, хранимую процедуру, URL-адрес или текст, зависящий от поставщика, для выполнения. При необходимости можно использовать имена таблиц, но только в том случае, если поставщик учитывает SQL. Например, если используется имя таблицы "Customers", ADO автоматически добавляет стандартный синтаксис SQL Select для формирования и передачи инструкции "SELECT * FROM Customers" в качестве инструкции Transact-SQL поставщику.
RecordsAffected
Необязательный элемент. Переменная Long , в которую поставщик возвращает количество записей, затронутых операцией.
Параметры
Необязательный элемент. Значение Типа Long , указывающее, как поставщик должен оценивать аргумент CommandText. Может быть битовой маской одного или нескольких значений CommandTypeEnum или ExecuteOptionEnum .
Примечание Используйте значение ExecuteOptionEnumadExecuteNoRecords , чтобы повысить производительность за счет минимизации внутренней обработки и для приложений, переносимых из Visual Basic 6.0.
Не используйте adExecuteStream с методом Execute объекта Connection .
Не используйте значения CommandTypeEnum adCmdFile или adCmdTableDirect с параметром Execute. Эти значения можно использовать только в качестве параметров с методами Open Method (ADO Recordset) и Requery Methodнабора Записей.
Комментарии
При использовании метода Execute в объекте объекта соединения (ADO) выполняется любой запрос, который вы передаете методу в аргументе CommandText для указанного соединения. Если аргумент CommandText указывает запрос, возвращающий строки, все результаты, создаваемые выполнением, сохраняются в новом объекте Recordset . Если команда не предназначена для возврата результатов (например, запроса SQL UPDATE), поставщик возвращает Nothing , если указан параметр adExecuteNoRecords ; В противном случае функция Execute возвращает закрытый набор записей.
Возвращаемый объект Recordset всегда является курсором только для чтения и только для переадресации. Если вам нужен объект Recordset с большими функциональными возможностями, сначала создайте объект Recordset с нужными параметрами свойств, а затем используйте метод Open Method (ADO Recordset) объекта Recordset, чтобы выполнить запрос и вернуть нужный тип курсора.
Содержимое аргумента CommandText зависит от поставщика и может быть стандартным синтаксисом SQL или любым специальным форматом команд, поддерживаемым поставщиком.
После завершения этой операции будет выдано событие ExecuteComplete.
Примечание
URL-адреса, использующие схему HTTP, автоматически вызывают поставщика Microsoft OLE DB для публикации в Интернете. Дополнительные сведения см. в разделе Абсолютные и относительные URL-адреса.