Метод 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-адреса.

Применение

Объект Connection (ADO)